AI 加了一条绕过鉴权中间件的路由 —— 排查与修复
AI 在鉴权路由组之外注册了新接口,把内部数据无防护暴露出去。识别缺口并把 auth 设为默认。
🐞 AI 编程工具问题
Cursor、Codex、Claude Code 应用修改失败、indexing 卡住、改错文件、回滚。
AI 编程工具最常见的痛点都是"它误改了我的代码"或"它没读到完整项目"。 这里把这些问题分工具收录：Cursor、Codex、Claude Code 各自的典型故障 + 回滚 / 恢复 / 防御策略。
常见问题
- Cursor 无法应用修改怎么办 Composer vs Inline、文件锁定、扩展冲突三种原因。
- Cursor 一直 indexing 怎么办 node_modules、build artifacts、忽略表配置。
- Cursor 没读到整个项目 Codebase 索引、@Files、symbol 引用三种显式注入方式。
- Codex 生成代码不符合项目结构 用 AGENTS.md / 引用现有文件来约束风格。
- AI 改代码后怎么回滚 git stash / restore / reflog 三招覆盖 99% 场景。
- Git commit 后怎么找回旧版本 git log -p、checkout <sha> -- <file>、reflog 三种方式。
- AI 写的测试通过但功能挂了 手写一条端到端测试；mock 列表 review；断言增强。
- AI 建议了过时依赖 装前必查 npm view <pkg> time；命令式核验。
本主题文章
AI 编造了根本不存在的 API 签名 —— 排查与修复
AI 信心满满地调用了一个并不存在的方法 —— 参数顺序错、选项名瞎编、返回类型臆造。通过对照真实源码定位与修复。
AI 生成的迁移本地能跑、上生产就炸 —— 排查与修复
AI 写的迁移在空 dev 库里干净通过,到生产却卡死或触发约束错误。关键是 dev-prod 一致性与迁移安全审查。
AI 写的 SQL 把热点表锁了好几分钟 —— 排查与修复
AI 写的查询或更新在生产表上持有长锁,阻塞读写。识别模式并改写为锁友好的版本。
AI 无视 lint 报错继续用废弃语法 —— 排查与修复
AI 生成的代码用了废弃 API,看到 lint 报错改了一处,下一个文件又把废弃写法塞回来。需要把规则锚定到项目层。
AI 在 pnpm / Yarn 项目里跑 npm 命令 —— 排查与修复
AI 在 pnpm 仓库里跑 npm install,生成了 package-lock.json,破坏锁文件契约、把 CI 弄崩。需要锁死包管理器。
AI agent 在循环、不进展怎么办
Agent 一直试同一个修法，或在两种状态之间反复——快速打断的方法。
本地 build 过，CI 挂——AI 改完最常见的坑
经典场景：AI 装了依赖没提 lockfile，或依赖了本地 Node 版本。
AI 改代码后 build 挂了——恢复与诊断
AI 跑完一轮 build 报错。用 diff review、类型检查和定向 revert 修。
AI agent 把 .env 覆盖了怎么办
Agent 用占位符重写或删了 .env——如何恢复并预防。
AI 凭空引用了不存在的文件：3 个原因 + 修复路径
Agent 写了 `src/utils/superhelper.ts` 这种从未存在的导入——常见但易修。
AI 编辑后 merge 冲突——解决指南
Claude Code 或 Cursor 改完 6 个文件、rebase 一打回车满屏 CONFLICT，难点是分辨格式噪音和真正的逻辑冲突。本文给一条隔离 AI commit、分层处理冲突的路径。
AI 编辑后 package-lock / pnpm-lock 冲突
Agent 装 / 删了依赖，lockfile 和团队的对不上了。
AI 重构生成了重复文件：3 个原因 + 修复路径
Agent 在原文件旁边建了 `UserList2.tsx` 这种重复文件——安全清理步骤。
AI 重构把还有用的逻辑删了：3 个原因 + 修复路径
AI 把 50 行重构成 28 行看着漂亮，两天后客服群冒出登录跳错页——它把某个客户场景的兜底分支当死代码删了。本文教你用 bisect 加 prod 日志精确定位并加回。
AI 写出来 TypeScript 类型错误
AI 出的代码过不了类型检查——通常是类型猜错、any 转换、漏掉泛型。
Claude Code 不理解你的项目怎么办：让 agent 真正读懂代码的 7 个方法
Claude Code 改了一半文件、问的问题对不上、找不到关键函数？多半不是模型不行，而是它没拿到正确的项目上下文。本文给出 7 个方法让 agent 一次就读懂你的项目。
Cursor 老是读错文件：3 个原因 + 修复路径
Cursor 把旧 / 生成 / vendored 文件拉进 context——靠索引和 ignore 修。
审核 AI 生成的 diff 该按什么顺序看
AI 给的 200 行 diff，编译过 ≠ 安全。这是阅读顺序。
多个 AI agent 同时改文件冲突了
两个 agent（Cursor + Claude Code）同时改了同一个文件——干净合并的方法。