comments-ajax.js 被 CDN 快取之後,不少使用者會遇到 AJAX 迴覆功能失效的情況。本文整理成因與修法,供需要的朋友參考。
這個腳本在初始化時,會從頁面中找出自己的 script 標籤,讀取 src 以取得自身所在位置,後續的 AJAX 請求都以這個位址為基準組出。但當它被 CDN 快取並從另一個網域載入時,src 指向的就是 CDN 網域而非你的網站網域,於是請求被打到快取伺服器上,自然得不到正確回應。
過去常見的消極做法是禁止 CDN 快取這個檔案,但這等於放棄了 CDN 的好處。較好的做法是讓腳本在執行時把網域改回自己的。
在 comments-ajax.js 中的這段之後:
var i = 0, got = -1, len = document.getElementsByTagName('script').length;
while ( i <= len && got == -1){
var js_url = document.getElementsByTagName('script')[i].src,
got = js_url.indexOf('comments-ajax.js');
i++ ;
}
加上一行:
js_url = js_url.replace('CDN地址','你的域名');
這樣就能解決。舉例來說:
js_url = js_url.replace('jb51.b0.upaiyun.com','jb51.net');
上面的做法需要你先查出 CDN 網域再手動填入,容易漏。改成正則抓出目前網域再替換即可:
var dm = js_url.match(/http:\/\/([^\/]+)\//i); js_url = js_url.replace(dm[1], '你的域名');
這樣只要填自己的網域就行,不必再去查 CDN 位址。完成後別忘了更新 CDN 上的 comments-ajax.js 並清掉快取,否則改動不會生效。
上述正則只處理 http,若你的站台走 https 就會比對失敗。改用更通用的寫法:
var dm = js_url.match(/^https?:\/\/([^\/]+)/i);
if (dm) {
js_url = js_url.replace(dm[1], location.host);
}
直接用 location.host 帶入目前網域,連手填都不必了。若你的 CDN 是走獨立網域,也可改為比對固定的 CDN 字串再替換,避免誤傷路徑中剛好出現相同字元的情況。
WordPress 升級到 3.6 之後,jQuery 更新為 1.10.2,並額外載入了 jQuery Migrate 來相容舊版 jQuery 寫法,代價是多了一次請求。
jQuery Migrate 的作用是偵測並試圖恢復那些在 jQuery 1.9 以上版本中已被移除或標記為不建議使用的 API,並在 console 印出警告。它的存在其實是個提醒:該把主題與外掛中老舊的 jQuery 寫法逐步換成新 API 了。若確認站台沒有依賴舊 API,可以在 functions.php 中把它移除:
add_filter( 'wp_default_scripts', function ( $scripts ) {
if ( ! empty( $scripts->registered['jquery'] ) ) {
$scripts->registered['jquery']->deps = array_diff(
$scripts->registered['jquery']->deps,
array( 'jquery-migrate' )
);
}
} );
但移除前務必完整測試站台的互動功能,因為不少老舊外掛仍暗中依賴 Migrate 提供的相容層。
comments-ajax.js 並非 WordPress 官方內容,而是社群自行開發的第三方腳本,多年來原作者已少有維護。若你只是想要 AJAX 留言功能,現階段更值得考慮的是:
一是改用原生 WordPress REST API 送留言(wp/v2/comments),自己寫一段簡短的送出邏輯;二是改用 Disqus、Utterances 這類成熟的留言服務,能同時解決垃圾留言與 CDN 相干擾的問題。
前者示例:
await fetch('/wp-json/wp/v2/comments', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ post: postId, content: text, author_name: name })
});
希望這份整理能解決你遇到的問題。