在 ASP.NET 專案裡掛 jQuery 與各類表格外掛,踩到的坑往往不是外掛本身,而是環境差異。
母版頁(Master Page)與內容頁的 script 載入順序是問題根源。內容頁的程式碼在母版頁的 jQuery 之前執行,此時 $ 還不存在,就會拿到「$ is not defined」。
解法是把 jQuery 等基礎函式庫的引用放在母版頁的 <head> 中,並確保位置在 ContentPlaceHolder 之前,讓所有內容頁都先取得核心物件再跑自己的邏輯。若少數頁面必須用不同版本,改用 ScriptManager 或批次打包管理,別在內容頁各自引一份,那很容易出現同一頁載入兩個 jQuery 而互相覆蓋的情形。
這個錯誤幾乎都指向同一件事:thead 裡 th 的數量與 tbody 每行 td 的數量不一致。DataTable 會依表頭建立欄位定義,資料列多一欄或少一欄,它在對應 oCol 時就取到 undefined。
檢查方式很直接:把表格用瀏覽器開發者工具攤開,數一次 th 與 td。ASP.NET 的 GridView、Repeater 樣板裡若忘了某個 <td>,或某列刻意做了 colspan 合併,都會造成這個落差。有合併需求的欄位不適合直接交給 DataTable 處理。
這個案例比較特別:外掛檔案第 908 行出現 £、$、€ 這類貨幣符號,被當成異常字元而導致整份腳本解析失敗,瀏覽器只會給一個籠統的語法錯誤,很難從訊息看出原因。
處理方式有兩種:短期先移除該行讓外掛能跑;根本做法是確認檔案的實際編碼與頁面宣告一致。這類問題通常源於檔案以某種編碼儲存,卻被伺服器以另一種編碼送出,中文字元與特殊符號就在解碼時變成亂碼。把 .js 檔統一存成 UTF-8 且不帶 BOM,並在頁面標明 <meta charset="utf-8">,可以一次解決大部分類似狀況。
這三個問題有個共同點:症狀看起來像外掛壞了,實際原因都在外掛之外。遇到 jQuery 相關的疑难,先確認「函式庫有沒有載入、順序對不對、DOM 結構合不合外掛的預期、檔案編碼是否正確」,通常比翻外掛原始碼更快找到答案。