Azure DevOps Pipeline推送文件至仓库报错，权限排查求助

核心问题与修复步骤 #

1. Git命令顺序完全错误 #

你在推送步骤里先执行了git push --set-upstream origin main，此时既没添加文件也没提交变更，本地根本没有可推送的内容，直接触发src refspec main does not match any错误。正确的操作顺序必须是：

Set-Location -Path $(Build.SourcesDirectory)/${{parameters.CoreRepository}}      
# 先将新增文件加入暂存区
git add .
# 提交本地变更
git commit -m "Committing the manifest file"
# 最后推送变更到远程分支
git push origin HEAD:main

2. Essentials仓库未开启凭证持久化 #

你仅给self仓库配置了persistCredentials: true，但要推送的essentials仓库未开启该选项。Azure DevOps默认不会将凭证共享给非当前仓库的检出目录，这就是触发could not read Password错误的直接原因。修改检出步骤：

steps:
- checkout: self
  persistCredentials: true
- checkout: 'essentials'
  persistCredentials: true # 给目标仓库也添加凭证持久化配置

3. Detached HEAD状态的潜在问题 #

错误日志显示提交是在detached HEAD状态下完成的，说明Pipeline检出essentials仓库时，拉取的是某个特定commit而非main分支。可以在推送前切换到main分支并拉取最新代码，避免本地与远程版本不一致：

Set-Location -Path $(Build.SourcesDirectory)/${{parameters.CoreRepository}}  
# 切换到main分支
git checkout main
# 拉取远程最新代码防止冲突
git pull origin main
# 执行添加、提交、推送流程
git add .
git commit -m "Committing the manifest file"
git push origin HEAD:main

额外检查项 #

• 确认$(Git.UserEmail)和$(Git.UserName)变量已在Pipeline中正确配置，否则Git提交会因身份配置失败报错。
• 再次核对My Project Build Service (My Org)账户权限，确保它拥有essentials仓库的写入权限（贡献者权限理论上包含写入，但可前往仓库权限设置页再次确认）。

内容的提问来源于stack exchange，提问作者imran chowdhury