启用双因素与SSH认证的Bitbucket Cloud下Source Link调试NuGet包失败求助

核心原因 #

Source Link默认通过HTTPS拉取源文件，而你的仓库采用SSH认证，调试器不会自动切换到SSH协议访问；同时启用2FA后，普通账号密码无法用于HTTPS认证，必须用Bitbucket的App Password替代。

解决步骤 #

• 生成Bitbucket App Password

  1. 登录Bitbucket Cloud，进入个人设置（右上角头像 > Personal settings）
  2. 选择App passwords，点击Create app password
  3. 给密码命名，仅勾选Repository Read权限（无需其他权限）
  4. 复制并保存生成的密码（仅显示一次，务必留存）

• 配置调试器认证信息

  • Visual Studio：
    打开Tools > Options > Debugging > Symbols，找到对应Bitbucket仓库的源链接条目，点击Edit，输入你的Bitbucket用户名和生成的App Password
  • Rider：
    打开File > Settings > Build, Execution, Deployment > Debugger > Symbols，找到目标源链接配置，添加用户名和App Password

• 修正Source Link配置
  确保项目的Source Link配置指向Bitbucket的HTTPS源地址，格式为：

  https://bitbucket.org/<你的用户名>/<仓库名>/raw/<提交哈希>/<文件路径>
  

  禁止使用SSH格式地址（git@bitbucket.org:...），调试器无法处理SSH协议的源链接请求。

• 验证配置有效性
  使用dotnet sourcelink test命令测试pdb文件的源链接：

  dotnet sourcelink test ./bin/Debug/YourProject.pdb
  

  该命令会逐个验证源文件的访问状态，若返回认证错误，说明调试器的认证配置未生效。

注意事项 #

• App Password遵循权限最小化原则，仅授予必要的仓库读权限
• 团队成员使用该NuGet包时，需各自配置个人的Bitbucket App Password
• 若符号加载正常但仍404，优先检查源链接的HTTPS地址是否正确，以及认证信息是否匹配

内容的提问来源于stack exchange，提问作者Mike D