Netlify 国内部署异常？Git 构建、Deploy Preview 与 Functions 排查
Netlify 的管理后台、Git Provider、构建容器、Deploy CDN 和 Functions 分属不同环节。国内用户常见的并不是整站永久不可用，而是登录回调慢、仓库列表加载不全、Build 日志中断、Deploy Preview 能开但自定义域名资源失败，或函数请求返回错误。
排查时先选定一个 Deploy，记下 Commit Ref 与 Deploy ID。控制台刷新不出日志，不代表云端构建没有继续；反过来，Publish 状态成功也不能证明表单、Identity、重定向和 Functions 已经工作。
从 Git 提交到页面请求拆开判断
Netlify 连接仓库后由 Webhook 触发构建，再按 Base Directory、Build Command 和 Publish Directory 生成产物。部署完成后，静态文件、边缘规则和 Functions 仍可能出现不同结果。
仓库选择器空白
核对 GitHub App 或 GitLab OAuth 的组织权限、仓库范围与浏览器回调，不要直接重建站点。
构建没有触发
查看 Deploy notifications、Webhook 事件、目标分支和 Ignore builds 规则。
构建成功但 404
重点检查 Publish Directory、单页应用重写规则和大小写，不一定是 CDN 访问问题。
页面正常而函数报错
Functions 有独立运行环境与日志，应检查区域、超时、环境变量和上游 API。
围绕一个 Deploy 完成闭环
- 1
固定站点配置
记录 Repository、Branch、Base、Package directory、Build command 与 Publish directory。
- 2
确认触发来源
检查此次 Deploy 来自 Git push、手动发布还是 Deploy Hook，并匹配 Commit Ref。
- 3
定位首个构建错误
从完整日志里区分依赖下载、插件、环境变量、构建命令和发布目录问题。
- 4
比较 Preview 与 Production
用同一产物测试 Deploy Preview、主域名及自定义域名，检查重定向、证书和缓存差异。
- 5
单独调用 Functions
用明确路径与请求参数复现，结合函数日志查看状态码、执行时间与上游响应。
日志窗口断开不等于构建停止
先回到 Deploy 列表查看最终状态与完整日志。不要因为浏览器流式日志中断就连续触发多次 Clear cache and deploy。
忍者云能改善哪些 Netlify 环节
忍者云可改善 Netlify 控制台、Git 授权、实时日志、Deploy Preview 与跨境静态资源的连接。固定节点还能减少 OAuth 过程中出口变化造成的会话重试。
线路不能纠正错误的 Publish Directory、重写规则、构建插件、环境变量或 Functions 代码，也不能替代 DNS 与证书配置。页面能开后仍应以 Netlify 的 Deploy 和 Function 日志作为故障依据。
适合改善
Dashboard、仓库授权、Deploy 日志、预览域名和产物资源加载。
仍需项目修复
构建配置、重定向、环境变量、函数异常、域名和第三方服务。
Ninja Cloud
稳定查看每一次 Netlify Deploy
忍者云帮助连接控制台、Git、Deploy Preview 与日志；构建目录、重写、Functions 和域名仍应按部署记录修复。
常见问题
Netlify 仓库列表加载不出来怎么办？
检查 Git Provider 授权是否覆盖目标组织和仓库，再确认 OAuth 回调与浏览器会话完整。
Deploy 成功为什么网站返回 404？
先检查 Publish Directory 是否包含 index.html，再核对 SPA 的重写规则、路径大小写和自定义域名配置。
Deploy Preview 正常，生产域名异常是什么原因？
两者可能使用不同上下文变量、域名、重定向和缓存；应在同一 Commit Ref 下逐项比较。
忍者云能修复 Netlify Functions 500 吗？
不能直接修复。线路可帮助查看日志和调用服务，但环境变量、代码异常、超时及上游 API 仍需开发者处理。