同版本NuGet包检索异常问题的成因排查与解决方案咨询

• GitLab NuGet仓库版本约束：GitLab默认不允许同一版本号的NuGet包重复发布，即便流水线显示发布成功，后续推送的同版本包可能被仓库静默拦截，或虽存储但未更新索引，导致客户端无法检索到新构建的包。
• NuGet客户端缓存机制：客户端会缓存已检索过的包信息，若本地缓存未更新，即使仓库已有最新包，也会优先读取缓存内容，无法获取重建后的版本。
• 版本号策略缺陷：采用「标签+构建版本号」但未将构建号纳入NuGet的唯一版本标识（如仅用1.0.0作为版本号，构建号仅内部记录），NuGet及GitLab仓库会将这些视为同一版本，不会区分存储或检索。

1. 优化版本号策略，确保版本唯一性 #

• 使用语义化版本的预发布格式，将构建号整合到版本号中，例如1.0.0-build202405201（主标签-构建时间/编号）。每个重建版本对应唯一的预发布版本号，GitLab会正常存储所有版本，NuGet客户端也能检索到全部条目。
• 避免使用1.0.0+build1这类构建元数据格式，部分仓库会忽略+后的内容，仍视为同一版本。

2. 配置GitLab允许覆盖同版本包 #

• 在项目的Settings > Packages and registries > NuGet Repository中，勾选「Allow duplicate packages」（不同GitLab版本路径可能略有差异），开启同版本包的覆盖权限。
• 在流水线的dotnet nuget push命令中添加--force参数，确保新构建的同版本包能覆盖旧版本：

  dotnet nuget push "path/to/package.nupkg" --source "$CI_NUGET_REPOSITORY" --api-key "$CI_JOB_TOKEN" --force
  

3. 清理客户端缓存 #

• 在需要检索包的环境中执行命令清除本地缓存：

  dotnet nuget locals all --clear
  

• 可将该命令加入流水线的构建前置步骤，避免依赖缓存导致的版本不一致问题。

4. 自动化清理旧版本包 #

• 编写CI/CD脚本，利用GitLab API自动删除同一主标签下的旧构建版本，减少手动操作成本。示例脚本：

  # 配置参数
  PACKAGE_NAME="YourPackageName"
  MAIN_VERSION="1.0.0"
  API_URL="$CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/nuget"
  
  # 获取同版本的所有旧包ID
  OLD_PACKAGE_IDS=$(curl --header "PRIVATE-TOKEN: $CI_JOB_TOKEN" "$API_URL?package_name=$PACKAGE_NAME&version=$MAIN_VERSION" | jq -r '.[].id')
  
  # 批量删除旧包
  for ID in $OLD_PACKAGE_IDS; do
    curl --request DELETE --header "PRIVATE-TOKEN: $CI_JOB_TOKEN" "$CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/$ID"
  done
  

• 注意：需确保流水线的CI_JOB_TOKEN拥有包管理的权限，且已安装jq工具用于JSON解析。

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