dotnet CLI提示GitLab私有源NuGet包无可用版本该如何解决？

1. 基础参数校验 #

• 检查包名拼写：NuGet包名字符完全匹配（大小写不敏感），确认dotnet add package后跟的包名和GitLab「Packages & Registries」页面显示的包名完全一致，没有多余字符、拼写错误。
• 检查源地址匹配性：执行dotnet nuget list source确认指定源对应的地址和包实际所在的源地址一致，GitLab不同层级的NuGet源地址不通用：
  • 项目级源格式：https://<gitlab域名>/api/v4/projects/<项目ID>/packages/nuget/index.json
  • 组级源格式：https://<gitlab域名>/api/v4/groups/<组ID>/-/packages/nuget/index.json
    包推送到项目级源时用组级源拉取、或者反过来，都会出现找不到包的问题。

2. 源权限配置校验 #

GitLab私有源访问失败不会明确抛出权限错误，只会返回空的包列表：

• 确认添加源时已经配置了正确的身份信息，完整的私有源添加命令为：

  dotnet nuget add source <源地址> -n <源名称> -u <GitLab用户名> -p <GitLab个人访问令牌> --store-password-in-clear-text
  

  如果添加时没有携带身份参数，会导致匿名访问被拒。
• 确认使用的GitLab个人访问令牌至少有read_package_registry权限，令牌未过期，且关联账号对目标仓库/组至少有访客权限。

3. 本地缓存与查询规则校验 #

• 清理本地NuGet缓存重试，错误的查询缓存会导致无法拉取到刚上传的包：

  dotnet nuget locals all --clear
  

• 如果你上传的是预览版包，dotnet add package默认不会拉取，需要额外加--prerelease参数指定。

4. 兼容性校验 #

检查待安装包的项目的目标框架，是否和NuGet包支持的目标框架兼容，例如包仅支持.NET 6时，.NET Framework项目安装就会提示无可用版本。 #

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