必须使用 hidden.bs.modal 而非 hide.bs.modal 监听 Modal 关闭事件，因后者在动画开始前触发、DOM 尚未移除，导致 location.reload() 失效或异常；正确做法是绑定 hidden.bs.modal，动态模态框需委托监听，避免重复绑定，并酌情使用 setTimeout 延迟刷新以兼容 iOS Safari。
Modal 关闭事件监听必须用 hidden.bs.modal，不是 hide.bs.modal
很多人写成 hide.bs.modal，结果父页面刷新不了——因为这个事件在动画开始前就触发了，此时模态框还没真正关闭，DOM 还在渲染中，location.reload() 可能被中断或失效。只有 hidden.bs.modal 是在动画完全结束、模态框彻底从 DOM 移除后才触发，才是安全的刷新时机。
常见错误现象：location.reload() 执行了但页面没刷新，或者刷新两次（误绑多次事件），或者在移动端卡住。
- 务必用
$('#myModal').on('hidden.bs.modal', ...)，不要用hide - 如果模态框是动态插入的（比如通过 AJAX 加载），监听要委托到
document或父容器，例如：$(document).on('hidden.bs.modal', '#myModal', ...) - 避免重复绑定：如果模态框反复打开/销毁，每次初始化都重新
.on()会累积监听器，建议先.off('hidden.bs.modal')
刷新前检查是否真需要 reload —— 避免无意义整页刷新
很多场景其实只需局部更新（比如表格重载、状态 badge 刷新），整页 location.reload() 体验差、浪费资源，还可能丢失表单草稿或滚动位置。
使用场景判断：
- 仅需更新某块内容 → 用
$.get()或fetch()重拉数据，再$().html()替换 - 表单提交成功后关闭 Modal → 后端返回 JSON，前端用返回数据更新对应 DOM，不刷新
- 确实要同步登录态、权限或路由状态 → 才考虑
location.reload()，且建议加location.reload(true)强制从服务器读取（绕过缓存）
多个 Modal 共存时，事件监听别写死 ID
如果页面有 #userModal、#orderModal 等多个模态框，每个都单独写 $('#xxx').on(...) 维护成本高，也容易漏掉。
更稳妥的做法是统一监听所有 Modal 的关闭事件，并通过 event.target 区分来源：
$(document).on('hidden.bs.modal', '.modal', function (e) {
const $modal = $(e.target);
if ($modal.data('reload-on-close') === true) {
location.reload();
}
});
这样只要给需要刷新的 Modal 加上 data-reload-on-close="true" 属性即可，解耦清晰，扩展性强。
移动端 Safari 下 location.reload() 可能不生效？
极少数 iOS Safari 版本（特别是 15.4–15.6）在 Modal 关闭后立即调用 location.reload()，会出现白屏或静默失败——本质是浏览器对快速 DOM 变更 + 导航的限制。
解决办法很简单：加个微小延迟，让渲染线程空出一帧：
- 改用
setTimeout(() => location.reload(), 10) - 不要用
0，10ms更稳妥；16ms（≈1 帧）也可，但没必要 - 仅在检测到
navigator.userAgent.includes('Safari') && !navigator.userAgent.includes('Chrome')时启用该兜底
真正麻烦的不是怎么写，而是忘记 Modal 可能被 ESC 关闭、点击遮罩关闭、点 × 关闭、调用 modal('hide') 关闭——这四种路径都必须走同一个事件出口，否则有的关不刷新，有的刷两次。
