踩坑地图

给 dialog 加了 aria-modal=true 就以为模态完成了，键盘用户仍能 Tab 进遮罩后的页面；命令面板焦点陷阱缺失的定位与补齐复盘。

Astro 内联脚本配合 define:vars 生成顶层声明，在 ClientRouter 下重复执行触发 SyntaxError，八个工具页交互一夜全灭的复盘。

订阅表单提供多主题频道，但 RSS/JSON Feed 生成器只遍历文章集合，导致按频道订阅的读者永远收不到非文章内容的一次契约漂移复盘。

原生 select 的固有宽度等于最长 option 文本，作为网格项时会撑大整条隐式轨道，360px 下页面横向溢出 154px 的复盘。

在启用 View Transitions/SPA 路由的站点里，命令面板与终端用 window.location.href 跳转会强制整页刷新，丢失过渡与内存态的复盘与锚点点击修复法。

状态结果页只按查询参数渲染，直接访问或从无参数入口进入时必然落入 invalid 分支，还被 sitemap 收录放大问题的一次复盘。

用 IntersectionObserver 做渐入揭示时，打印、脚本禁用、观察者漏触发三种情况会让内容永久不可见，配自愈与打印兜底的解法。

服务端渲染时向自身 origin 发起回环请求读构建产物，被 HTTPS 重写拦截后错误落入 catch，页面把"取数失败"伪装成"暂无数据"的复盘。

后端在数据库故障时复用了 invalid 状态码，前端按 state 映射文案，服务不可用被误导为输入错误的跨层契约复盘。

在 SSR 项目中预渲染内容详情页时集合提示为空的排查——loader 显式配置、schema 校验与构建期防护的完整记录。