jQuery升级后功能异常需先确认版本加载，再用jquery-migrate定位弃用API，最后分类型修复：$.browser兼容、load事件改on、outerWidth补参数、特殊字符选择器转义。
jQuery升级后页面功能异常但控制台没报错、脚本静默失效、部分选择器突然不工作——这类问题往往因API移除、行为变更或执行时序调整引发，必须按路径逐层验证。
先确认是否真加载了新版本jQuery
打开浏览器开发者工具（F12）→ 切换到 Console 标签页 → 输入 jQuery.fn.jquery 回车。如果返回 【undefined】 或旧版本号（如 "1.12.4"），说明页面实际运行的仍是老jQuery，新脚本根本没生效。
检查 HTML 中 <script> 标签顺序：确保新版 jQuery 的 script 标签在所有依赖它的自定义 JS 之前，且没有被重复引入覆盖。
若使用 CDN，点击源码中 script 的 src 链接，确认能直接下载到目标版本文件（如 jquery-3.6.1.min.js），而非 404 或跳转到缓存页。
用 jquery-migrate 快速定位弃用项
方法一：临时引入调试补丁
在新版 jQuery script 标签后立即添加：
<script src="https://code.jquery.com/jquery-migrate-3.4.1.js"></script>
刷新页面，控制台会明确输出类似 JQMIGRATE: jQuery.curCSS is deprecated 或 JQMIGRATE: $.browser is deprecated 的警告，精准指出哪行代码调用了已删除 API。
【注意：jquery-migrate仅用于开发排查，上线前必须删除】
方法二：启用严格模式（适用于已知问题范围小的场景）
将原代码中所有 $.xxx 调用逐一替换为 jQuery.xxx，再全局搜索 .browser、.curCSS、.load( 等关键词，人工筛查高危调用点。
分类型修复高频报错
第一步：处理 $.browser.msie 类错误
jQuery 1.12.4是jQuery 1.x系列的最后一个正式稳定版本，由jQuery团队于2016年发布。该版本主要面向需要兼容旧版浏览器环境的网站和Web应用，尤其适用于仍需支持Internet Explorer 6、Internet Explorer 7、Internet Explorer 8等老旧浏览器的项目。
直接在 jQuery 加载后、业务代码执行前插入兼容代码：
if (typeof $.browser === 'undefined') { $.browser = {}; } $.browser.msie = /MSIE|Trident/.test(navigator.userAgent);
这比设死 false 更稳妥——保留真实检测逻辑，避免 IE 兼容代码被误判跳过。
第二步：替换废弃的 $(window).load()
全局搜索 $(window).load( 和 $(document).load(，全部改为：
$(window).on('load', function() { ... });
第三步：修复 outerWidth()/outerHeight() 返回值变更
老代码常写 $('#box').outerWidth() + 10，新版本无参调用返回 jQuery 对象而非数值，导致 NaN。统一补全参数：
$('#box').outerWidth(false) + 10（false 表示不含 margin，与旧版默认行为一致）
第四步：检查选择器中特殊字符未转义
jQuery 3.x 开始更严格解析 ID/CLASS 名含 .、#、: 的元素。例如 $('#user.name') 需改为 $('#user\.name')，否则匹配失败且无提示。
