將運行正常的 jQuery 代碼遷移到 JSP 頁面後失效,是 Java Web 開發中極高頻的「坑」。核心原因在於 **JSP 的表達式語言 (EL) 默認使用 `${...}` 語法,而 jQuery 大量使用 `$` 作為核心函數別名**,兩者在 JSP 編譯階段發生衝突。本文深度解析衝突機制,提供多種解決方案與最佳實踐。
JSP 容器(Tomcat/Jetty 等)在編譯 JSP 為 Servlet 時,會解析 `${...}` 表達式。若頁面中出現 ``,容器嘗試解析 `$(` 為 EL 表達式開頭,導致:
EL 表達式語法錯誤$ is not a function<%@ page contentType="text/html;charset=UTF-8" %>
<html>
<head>
<script src="jquery.js"></script>
<script>
$(function() { // ← JSP 編譯器嘗試解析 $(...
$('#select1 option:selected').appendTo('#select2');
});
</script>
</head>
...
jQuery(function() {
jQuery('#add').click(function(){ jQuery('#select1 option:selected').appendTo('#select2') });
// 所有 $ 替換為 jQuery
});
<script src="jquery.js"></script>
<script>
// 1. 釋放 $,歸還給其他庫/EL表達式
var $j = jQuery.noConflict(); // 自定義別名,如 $j, jq, $
// 2. 之後使用 $j 或 jQuery
$j(function() {
$j('#add').click(function(){ $j('#select1 option:selected').appendTo('#select2') });
});
// 3. 若仍需在局部使用 $,用 IIFE 封裝
(function($) {
$(function() {
// 此處 $ 安全指向 jQuery
$('#add').click(...);
});
})($j); // 或 jQuery
</script>
優點:徹底解決衝突、不影響第三方插件、代碼風格不變(IIFE 內部)。
<%@ page isELIgnored="true" %>
<script>
// 使用 \u0024 轉義 $ (Unicode: U+0024)
\u0024(function() { ... });
// 或字符串拼接繞過編譯器
['$', '(', 'function()', '{', '}'].join('');
</script>
<!-- JSP 頁面 -->
<script src="page-logic.js"></script>
<!-- page-logic.js -->
$(function() {
// 純 JS 文件不經 JSP 編譯,$ 完全安全
$('#add').click(...);
});
若使用 Webpack/Vite/Rollup 等構建工具,可配置自動注入 noConflict 或重命名:
// webpack.config.js
const webpack = require('webpack');
module.exports = {
plugins: [
new webpack.ProvidePlugin({
$: 'jquery',
jQuery: 'jquery',
'window.jQuery': 'jquery'
})
]
};
// 入口文件
import $ from 'jquery';
$.noConflict(); // 釋放全局 $
var $j = $; // 模塊內使用 $j 或直接用導入的 $
export default $j;
// main.js
import $ from 'jquery';
window.jQuery = $;
window.$ = $; // 若確定無衝突可保留
// 或
const $j = $.noConflict(true); // true 同時釋放 jQuery 變量
export default $j;
jQuery `$` 與 JSP EL `${}` 衝突是**模板引擎與前端庫符號佔用**的經典案例。解決層級由低到高:
noConflict() + IIFE(標準庫級方案)現代前端工程化下,**「JS 代碼不寫在 JSP/模板內」**是避免此類衝突的根本之道,同時也帶來緩存、維護、協作等綜合收益。