是，因.modal-body未设max-height导致无高度限制，overflow-y: auto失效；须显式设置max-height（如70vh），并确保滚动样式作用于.modal-body本身。
Modal 内部滚动条不生效，是不是没触发 overflow？
不是样式写错了，而是 .modal-body 根本没进入可滚动状态。Bootstrap 5 的 .modal-body 默认不设 max-height，只靠内容撑开——没有高度限制，overflow-y: auto 就是摆设。
实操建议：
- 必须显式给
.modal-body加max-height（推荐用70vh或具体像素值），不能只依赖 Bootstrap 默认行为 - 确认 DevTools 中
.modal-body计算后的overflow-y是auto，不是visible或inherit - 避免同时设
height和overflow-y：固定高容易在小屏裁切内容，max-height更安全 - 移动端 Safari 需额外加
-webkit-overflow-scrolling: touch，否则惯性滚动失效
.modal-body::-webkit-scrollbar 没反应？选错目标了
写了全局 body::-webkit-scrollbar 或 .modal::-webkit-scrollbar，但滚动条样式依然原样——因为伪元素只作用于「实际产生滚动的容器」，而模态框里真正溢出的是 .modal-body，不是外层。
实操建议：
- 样式必须直接挂在
.modal-body上：.modal-body::-webkit-scrollbar、.modal-body::-webkit-scrollbar-track、.modal-body::-webkit-scrollbar-thumb - 不要用
!important强刷，优先提高选择器权重，比如.my-modal .modal-body::-webkit-scrollbar -
width只对垂直滚动条有效；height是给水平滚动条用的，模态框极少需要 - Firefox 完全不识别
::-webkit-scrollbar，得另配scrollbar-width和scrollbar-color
Firefox 里 scrollbar-width: thin 不起作用？系统和版本卡住了
即使写了 .modal-body { scrollbar-width: thin; scrollbar-color: #6c757d #f8f9fa; }，Firefox 还是显示粗滚动条——这不是 CSS 写错了，而是浏览器或系统限制。
实操建议：
- 确认 Firefox 版本 ≥ 64（2026 年基本都满足，但内网旧终端可能卡在 ESR 60）
- macOS 用户检查「系统偏好设置 > 通用 > 显示滚动条」是否为「自动」或「当滚动时」；设成「始终」会忽略
thin -
scrollbar-width和scrollbar-color必须写在同一选择器里，拆成两条规则无效 - 别指望它和 Chrome 效果一致：Firefox 的
thin是提示，不是强制；Windows 下多数情况仍按默认宽度渲染
滚动后 backdrop 点不了、模态框卡住？z-index 被内部元素劫持了
不是滚动条样式的问题，而是 .modal-body 里某个子组件（比如富文本编辑器、下拉菜单、日期选择器）动态设置了 z-index，盖住了 .modal-backdrop，导致点背景无法关闭。
实操建议：
- 禁止给
.modal-body或其直系子元素设position: relative+z-index，除非你明确知道层级链路 - 检查第三方组件初始化逻辑，有些库会在
shown.bs.modal后自动聚焦并提升自身z-index - 兜底方案：在
shown.bs.modal回调里重置可疑元素的z-index，例如$('.ql-toolbar, .datepicker').css('z-index', '100') -
.modal-backdrop默认z-index: 1040，.modal是1055，内部元素应严格控制在1050以下
