Azure Web App（Linux）Git部署遇403错误求助

遇到fatal: unable to access... The requested URL returned error: 403这种错误，基本都是认证环节出了问题，结合你描述的配置情况，我整理了几个针对性的排查和解决步骤：

1. 先确认部署凭据的正确性 #

很多人容易在这里踩坑：部署凭据的用户名不是你的Azure订阅邮箱，而是你在「部署凭据」设置里专门创建的用户名（如果是自动生成的，格式可能是$webappname），密码也是你单独设置的部署密码，和Azure账户登录密码不是一回事。

你可以重新登录Azure门户，进入Web App的「部署中心」→「部署凭据」，仔细核对用户名和密码，最好直接复制粘贴这些信息，避免手动输入时的拼写错误。

2. 清除Git缓存的旧凭据 #

Git会自动缓存你输入过的凭据，如果之前输错过用户名/密码，哪怕后来纠正了，Git还是会用旧缓存去认证，导致403。你可以按系统类型清除缓存：

Windows系统 #

git config --global credential.helper wincred
git credential-manager uninstall
# 重新安装凭据管理器
git credential-manager install

Linux/macOS系统 #

# 先查看当前使用的凭据助手
git config --global credential.helper
# 如果是store，直接删除凭据文件
rm ~/.git-credentials
# 如果是cache，清除临时缓存
git credential-cache exit

之后再执行git clone或git push，Git会重新提示你输入凭据，这时输入正确的部署用户名和密码即可。

3. 手动在Git命令中嵌入凭据（临时测试用） #

如果缓存问题还是没解决，你可以直接把凭据放到Git URL里（注意：这种方式会明文保存密码，仅用于临时测试，之后记得修改回正常URL）：

git clone https://{username}:{password}@{webappname}.scm.azurewebsites.net:443/{webappname}.git

或者修改已有的远程源：

git remote set-url azuretestgit https://{username}:{password}@{webappname}.scm.azurewebsites.net:443/{webappname}.git

之后再尝试git push -u azuretestgit master，看是否能成功。

4. 验证Web App的Git部署是否正常启用 #

有时候配置变更可能导致Git部署被意外禁用，你可以：

• 进入Azure门户的Web App「部署中心」，确认部署方法是「本地Git」
• 核对「部署中心」显示的Git克隆URL和你使用的是否完全一致（注意webappname的大小写、拼写，有没有多写少写字符）

5. 排查网络限制 #

如果你的机器在企业网络下，防火墙或代理可能阻止了对*.scm.azurewebsites.net的443端口请求：

• 换手机热点等其他网络测试，看是否能正常操作
• 检查本地防火墙设置，确认允许Git访问外部HTTPS资源
• 如果用了代理，需要在Git中配置：

git config --global http.proxy http://你的代理服务器:端口
git config --global https.proxy https://你的代理服务器:端口

（测试完成后记得取消代理：git config --global --unset http.proxy和git config --global --unset https.proxy）

6. 尝试SSH部署（可选） #

如果HTTPS方式始终有问题，你可以试试SSH部署：

1. 在Azure门户的Web App「部署中心」→「本地Git/FTPS」里，获取SSH克隆URL（格式类似git@ssh.azurewebsites.net:v3/{webappname}/{webappname}.git）
2. 生成SSH密钥对，把公钥添加到Azure门户的「部署凭据」→「SSH公钥」中
3. 用SSH URL执行克隆或push操作，这种方式依赖密钥认证，不需要输入密码，可能绕过HTTPS的认证问题

内容的提问来源于stack exchange，提问作者Himanshu Mohan