推送NuGet符号包至Artifactory时名称被修改并覆盖主包问题

核心问题现象 #

• 推送.symbols.nupkg或.snupkg时，文件名中的.symbols/.snu后缀被自动移除，导致符号包覆盖主包
• Artifactory未按预期解析PDB文件，仓库根目录下的.symbols/目录无对应符号数据
• 尝试多种推送方式（--symbol-source参数、分仓库推送、原生NuGet客户端、snupkg格式）均无效
• 运行环境为微软官方dotnet:7.0 Debian 10容器

解决方案 #

1. 检查Artifactory仓库的符号处理配置 #

进入目标NuGet仓库的配置页面，找到NuGet Settings板块：

• 确保勾选Enable Symbol Server选项，符号存储路径保持默认的.symbols/即可
• 将Handle Symbols Packages设置为Automatic，该选项控制Artifactory是否自动解析符号包中的PDB并生成对应目录结构
• 注意：若仓库为新创建或配置被修改过，该选项可能默认关闭

2. 修正NuGet推送命令的源配置 #

Artifactory的NuGet仓库本身支持同时处理主包和符号包，无需单独指定符号源：

• 批量推送主包+符号包的正确命令：

  dotnet nuget push "YourPackage.*.nupkg" --source https://your-artifactory-url/api/nuget/your-nuget-repo --api-key YOUR_API_KEY
  

• 单独推送符号包的命令：

  dotnet nuget push "YourPackage.symbols.nupkg" --source https://your-artifactory-url/api/nuget/your-nuget-repo --api-key YOUR_API_KEY
  

• 关键点：推送源必须是Artifactory的NuGet仓库地址，而非通用符号源地址

3. 验证容器内NuGet客户端与SDK兼容性 #

dotnet:7.0容器的默认NuGet版本可能存在兼容性问题：

• 升级NuGet客户端到最新稳定版：

  dotnet tool update -g nuget
  

• 检查版本：nuget --version，确保使用5.x及以上版本
• 更新dotnet SDK到7.0最新补丁版，避免SDK自带的推送bug：

  apt update && apt install -y dotnet-sdk-7.0
  

4. 确认符号包结构符合规范 #

• 对于.symbols.nupkg：确保PDB文件放置在lib/[framework]目录下，或根目录的symbols/文件夹中
• 对于.snupkg：必须通过dotnet pack --include-symbols --include-source生成，禁止手动重命名文件
• 可通过解压包验证结构：unzip YourPackage.symbols.nupkg -d temp，检查PDB文件是否存在且路径正确

5. 排查权限与反向代理配置 #

• 确认推送用的API Key拥有Deploy和Annotate权限（Artifactory需要Annotate权限完成符号解析）
• 检查Artifactory前端的反向代理（如Nginx）是否篡改了请求路径或文件名
• 查看Artifactory请求日志（$ARTIFACTORY_HOME/logs/request.log），确认文件名在到达服务器时是否已被修改

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