同事在專案裡引入了 ASP.NET AJAX(beta 1 版),用著用著,瀏覽頁面時開始不定時跳出「'Sys' 未定義」的錯誤。照著網路上的建議把 web.config 翻來改去,效果依然是零。
仔細想想也不合理:web.config 從頭到尾都沒動過,憑什麼突然把責任算在它頭上?繼續摸索之後才找到真正的原因——是身分驗證惹的禍。
在一個啟用了表單驗證的網站中,未登入狀態下存取任何資源都會被拒絕並轉向登入頁。ASP.NET AJAX 的腳本本身就是透過 .axd 這類 IHttpHandler 動態輸出的,頁面上看得到類似這樣的引用:
<!-- ASP.NET 本身的腳本 -->
<script src="/ADCAdminPortal/WebResource.axd?d=oaHQugHLcngT9QBb6bqlOQ2&t=632980334575156250"
type="text/Javascript"></script>
<!-- ASP.NET AJAX 的腳本 -->
<script src="/ADCAdminPortal/ScriptResource.axd?d=yvZpRQrDbxpfjwZQ-..." type="text/Javascript"></script>
問題就在這裡:一般網站都會有部分頁面不需要登入,例如首頁、新聞頁、登入頁本身。當使用者打開這些公開頁面時,瀏覽器依序去抓 .axd 腳本,卻因為尚未通過驗證而被導向登入頁面。腳本抓不到,頁面上對 AJAX 的呼叫自然無從完成,於是就報出了「Sys 未定義」。
把 ScriptResource.axd 明確標示為不需要驗證,錯誤就徹底消失了:
<location path="ScriptResource.axd">
<system.web>
<authorization>
<allow users="*"/>
</authorization>
</system.web>
</location>
另外要注意,使用 Visual Studio 2005 內建的 Web Server 時,所有檔案都會經過 ASP.NET 處理,這也是為什麼未登入頁面上的圖片顯示不出來的同一個原因。
依經驗判斷,九成左右的 ASP.NET AJAX「Sys 未定義」錯誤都源自於腳本資源無法被解析。與其猜,不如直接驗證:
<script> 標籤裡的 src 值複製下來,貼到網址列直接拜訪。如果看到的只是一頁白底黑字的「無法找到網頁」IIS 錯誤頁,那反而與 ASP.NET 無關,應檢查 IIS 的預設延伸模組對應是否被改動過;若無異常,把虛擬目錄刪掉重建通常就能恢復。也曾遇過一次部署到 IIS 後又冒出腳本錯誤,最後發現是 AJAX 腳本資源同樣沒被解析,重建虛擬目錄後問題消失。真的還是不行,就在 IIS 重新註冊一次 ASP.NET。