企业代理环境下运行SBT遇依赖解析失败问题求助

你已经尝试通过SBT_OPTS配置代理，但还是碰到了依赖解析失败的问题，我来帮你排查几个常见的坑，一步步解决：

1. 优先拆分代理凭证配置（避免编码问题） #

如果你的用户名或密码包含@、:、%这类特殊字符，直接把凭证嵌在代理host里会导致JVM解析出错。建议分开配置用户名和密码，格式如下：

export SBT_OPTS="$SBT_OPTS -Dhttp.proxyHost=correcthost -Dhttp.proxyPort=correctport -Dhttp.proxyUser=myusername -Dhttp.proxyPassword=mypassword -Dhttps.proxyHost=correcthost -Dhttps.proxyPort=correctport -Dhttps.proxyUser=myusername -Dhttps.proxyPassword=mypassword"

这种方式不需要对特殊字符做URL编码，更不容易出错。

2. 添加非代理主机规则 #

企业环境中，SBT可能需要访问本地仓库、localhost或者公司内部域名，这些地址走代理会失败。你可以加上非代理主机参数：

export SBT_OPTS="$SBT_OPTS -Dhttp.nonProxyHosts=localhost|127.0.0.1|*.yourcompany.com"

把公司内部的域名后缀也加进去，确保内部依赖不走代理。

3. 改用SBT专属配置文件（更稳定） #

有时候环境变量的配置会被其他设置覆盖，直接用SBT的专属配置文件更可靠：

• 在用户目录下创建~/.sbt/repositories文件，指定仓库源：

[repositories]
  local
  maven-central: https://repo1.maven.org/maven2/
  typesafe-ivy-releases: https://repo.typesafe.com/typesafe/ivy-releases/, [organization]/[module]/(scala_[scalaVersion]/)(sbt_[sbtVersion]/)[revision]/[type]s/[artifact](-[classifier]).[ext]

• 再创建~/.sbtopts文件，写入代理参数：

-Dhttp.proxyHost=correcthost
-Dhttp.proxyPort=correctport
-Dhttp.proxyUser=myusername
-Dhttp.proxyPassword=mypassword
-Dhttps.proxyHost=correcthost
-Dhttps.proxyPort=correctport
-Dhttps.proxyUser=myusername
-Dhttps.proxyPassword=mypassword
-Dhttp.nonProxyHosts=localhost|127.0.0.1|*.yourcompany.com

SBT启动时会自动加载这个文件的配置，优先级比环境变量更高。

4. 排查NTLM代理特殊情况 #

如果你的企业代理用的是NTLM认证，普通JVM参数无法处理，需要添加额外配置：

export SBT_OPTS="$SBT_OPTS -Dhttp.proxyHost=correcthost -Dhttp.proxyPort=correctport -Dhttps.proxyHost=correcthost -Dhttps.proxyPort=correctport -Dhttp.auth.ntlm.domain=YOUR_COMPANY_DOMAIN -Djava.net.useSystemProxies=true"

替换YOUR_COMPANY_DOMAIN为你的企业域，比如corp或者公司全称。

5. 先验证代理连通性 #

用curl手动测试代理是否能访问Maven中央仓库，确认代理本身没问题：

curl -x http://myusername:mypassword@correcthost:correctport https://repo1.maven.org/maven2/org/scala-sbt/sbt-launch/1.9.0/sbt-launch-1.9.0.jar

如果curl能下载文件，说明代理权限、凭证都没问题，问题出在SBT配置；如果curl失败，先找IT确认代理的访问权限和凭证正确性。

最后，记得清空SBT的缓存（删除~/.sbt和~/.ivy2目录），再重新运行sbt new sbt/scala-seed.g8试试。

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