Bolt 发布到 Netlify 老失败时，最怕的是把所有问题都归成“Netlify 抽风”。Bolt 官方支持文档里其实已经把最常见的坑拆得很清楚：一种是发布链路本身失败，一种是域名还占在旧项目上，还有一种是 GitHub 账号和 Bolt 账号的认证关系打架。
先说最直接的判断法。如果你点 Publish 就报错，但项目本身能正常 build，优先把它当成“发布链路问题”，而不是应用代码错误。Bolt 官方甚至直接给了兜底方案：先本地或在项目里跑 build，再下载项目，手动去 Netlify 做 manual deploy。能手动发上去，说明代码大概率没问题，卡的是 Bolt 到 Netlify 的那一段。
如果报错里提到“another project is already using this domain”，重点就不是重新点发布，而是去看这个域名是不是还挂在之前的 Netlify 项目或别的托管商上。很多人已经在 Bolt 里删过旧配置了，但域名提供方或旧托管平台那边还没断干净，所以新项目一直抢不过来。
还有一类问题跟 GitHub 绑定有关。Bolt 文档也提到，如果你曾经用同一个 GitHub 账号登录过不同的 Bolt 账号，后面再拿这个 GitHub 账号做集成认证，可能会发生冲突。表面上看像 Netlify 连不上，实际是账户关系没理顺。
所以最稳的排查顺序是：
1. 先确认项目能否正常 build。
2. 能 build 就尝试手动 deploy，验证是不是 Bolt 发布链路问题。
3. 如果是自定义域名报错，回旧托管平台把域名解绑干净。
4. 如果是集成登录怪异，检查 GitHub 账号是不是被多个 Bolt 账号复用过。
很多人一着急就反复点 Publish，结果只是重复触发同一个失败条件。真正高效的做法，是先把问题归类。代码问题、域名问题、认证问题，修法完全不是一套。
所以 Bolt 发不到 Netlify，别先全怪 Netlify。先搞清楚你卡在哪一层，通常很快就能从“反复发布失败”变成“知道该找谁、改哪一步”。
