SBT 1.0+版本解析器是否不再使用Credentials？

我之前帮团队排查过SBT从0.13.x升级到1.0.x后，在全新环境发布到VSTS包仓库的问题，总结了几个最容易踩的坑和解决办法：

一、先搞定插件兼容性 #

SBT 1.0.x对插件的版本要求很严格，你之前0.13.16用的VSTS发布插件大概率不适配1.0.x版本：

• 打开project/plugins.sbt，把原来的VSTS相关插件替换成支持SBT 1.x的版本（如果官方有更新的话）
• 如果找不到适配的官方插件也不用慌，直接用通用的Ivy发布配置就行——毕竟VSTS包仓库本身是兼容Ivy规范的

二、调整发布配置的语法细节 #

SBT 1.0.x在发布配置上有一些细微的语法和逻辑变化，别直接照搬0.13.x的配置：

• 先确认publishTo的配置，和老版本写法类似，但要确保和认证配置绑定正确：

  publishTo := Some("VSTS Packages" at "https://your-account.pkgs.visualstudio.com/_packaging/your-feed/maven/v1")
  

• 认证信息别硬编码在项目里，建议放在~/.sbt/1.0/credentials文件里（注意是1.0目录，不是0.13的），内容格式如下：

  credentials += Credentials(
    "VSTS Package Registry",
    "your-account.pkgs.visualstudio.com",
    "你的个人访问令牌(PAT)", // 记得给这个令牌开Packaging的Publish权限
    ""
  )
  

• 如果发布时遇到格式兼容问题，可以试试切换发布格式：publishMavenStyle := false（用Ivy格式发布），或者确认VSTS的feed已经开启了Maven格式支持

三、全新环境下的缓存与依赖解析问题 #

SBT 1.0.x的缓存机制和老版本完全独立，全新环境不会复用0.13.x的Ivy缓存，所以要注意：

• 把VSTS的feed也加到resolvers里，不然发布时可能找不到依赖导致失败：

  resolvers += "VSTS Packages" at "https://your-account.pkgs.visualstudio.com/_packaging/your-feed/maven/v1"
  

• 检查updateOptions配置，如果有禁用缓存的设置（比如withCachedResolution(false)），改成true，不然每次都重新拉取依赖，容易出问题

四、权限与认证的细节坑 #

VSTS的PAT令牌在SBT 1.0.x里有几个容易忽略的点：

• 令牌的权限必须包含Packaging (Publish)，而且作用域要选对（是组织级还是项目级，根据你的feed位置来）
• 可以用环境变量来传递令牌，避免明文写在配置里，比如：

  credentials += Credentials(
    "VSTS Package Registry",
    "your-account.pkgs.visualstudio.com",
    System.getenv("VSTS_PAT"),
    ""
  )
  

五、搞不定就开调试日志 #

如果还是卡壳，直接开SBT的调试日志找问题：

• 运行命令：sbt -Dlog.level=debug publish
• 重点看认证环节、依赖解析环节的错误信息，同时去VSTS的包仓库日志里查有没有拒绝访问或者格式错误的记录

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