为何GitLab包仓库重复存储同版本同名称NuGet资产而非替换？

问题说明 #

通过GitLab CI/CD推送名称和版本完全相同的.nupkg文件时，GitLab包仓库不会替换原有包，而是重复存储相同版本的资产。

原因 #

GitLab默认禁止覆盖已存在的同版本NuGet包，这是为避免误操作覆盖稳定版本而设计的特性。

解决方法 #

方案1：使用唯一版本号（推荐） #

每次构建生成唯一版本号，从根源避免重复版本问题，还能关联CI构建记录。修改CI脚本中的dotnet pack命令，加入动态版本参数：

修改后的gitlab-ci.yml配置：

variables:
  PROJECT_NAME: "MyCompany.StandardUtils"
  # 自定义基础版本号，可按需调整
  BASE_VERSION: "1.0"
  
image: mcr.microsoft.com/dotnet/sdk:6.0

stages:
  - deploy

deploy:
  stage: deploy
  script:
    # 用GitLab内置流水线ID生成唯一版本，格式为「基础版本.流水线序号」
    - dotnet pack $PROJECT_NAME.csproj -c Release -p:Version=${BASE_VERSION}.${CI_PIPELINE_IID}
    - dotnet nuget add source "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json" --name gitlab --username gitlab-ci-token --password $CI_JOB_TOKEN --store-password-in-clear-text
    - dotnet nuget push "bin/Release/*.nupkg" --source gitlab
  only:
    - master
  environment: production

CI_PIPELINE_IID是GitLab内置变量，代表项目内唯一的流水线序号，确保每次构建的版本号不重复。

方案2：开启GitLab包仓库的版本覆盖权限（不推荐生产环境） #

如果必须使用固定版本号覆盖，可开启项目的包覆盖设置：

1. 进入GitLab项目页面，点击左侧菜单 设置 → 通用
2. 滚动到包仓库区域，勾选允许重复的NuGet包版本选项
3. 保存设置后重新执行CI流水线，同版本的NuGet包将被覆盖

注意：此操作会破坏版本的不可变性，生产环境使用可能导致依赖该版本的项目意外引入变更，需谨慎操作。

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