Netlify PR部署预览失败：缺失git pull/27/head引用

核心原因 #

你遇到的问题是Netlify尝试拉取PR的源分支引用pull/27/head，但该引用已失效：

• pull/xxx/head指向PR的源分支最新提交，而pull/xxx/merge是GitHub自动生成的、用于预览合并效果的临时分支
• 当PR的源分支被删除，或者源分支的提交被强制推送覆盖（比如rebase后强推），GitHub会自动移除对应的pull/xxx/head引用，仅保留pull/xxx/merge
• 少数情况是GitHub的refs同步延迟，或Netlify本地仓库索引未更新，导致拉取时找不到有效引用

解决步骤 #

• 检查PR对应的源分支状态：去GitHub仓库确认源分支是否存在，是否有强制推送改写commit历史的记录。如果分支已删除需恢复；如果是强推导致，重新推送源分支的正确版本
• 强制Netlify重新抓取仓库refs：在Netlify的仓库设置页，点击「Trigger a deploy」并选择「Clear cache and deploy site」，让Netlify重新拉取所有仓库引用
• 重建PR引用关联：关闭当前PR后重新创建，或在GitHub上编辑PR（比如修改描述），触发GitHub重新生成pull/27/head引用
• 临时替代部署：在Netlify部署设置中，手动指定pull/27/merge作为部署分支，跳过对pull/27/head的依赖

内容的提问来源于stack exchange，提问作者Jason Ross