封闭网络中Scala项目本地仓库搭建失败求助

问题背景 #

需要在封闭网络环境运行Scala项目，尝试将本地Ivy缓存（~/.ivy2/cache）复制为本地仓库，但SBT无法找到任何构件。已执行的操作：

1. 关闭Couriser（useCouriser := false）并构建项目，通过rsync -av ~/.ivy2/cache/ /opt/sbt-repo/ivy/将缓存复制到/opt/sbt-repo/ivy
2. 配置~/.sbt/repositories为：

[repositories]
  local
  ivy-repo1: file:///opt/sbt/ivy/
  ivy-repo2: file:///opt/sbt/ivy/, [organization]/[module]/[type]s/[artifact]-[revision].[ext]

核心问题分析 #

1. 路径不匹配：复制目标路径是/opt/sbt-repo/ivy，但配置中写的是/opt/sbt/ivy/，路径不一致导致SBT无法定位仓库。
2. 组织名格式不匹配：Ivy缓存中组织名将点（.）替换为斜杠（/）（比如org.scala-lang变成org/scala-lang），但配置里的[organization]会保留点分隔符，导致路径匹配失败。
3. 元数据缺失：Ivy缓存中可能缺少依赖的元数据文件（ivy.xml或pom.xml），SBT需要这些文件解析依赖的版本、依赖关系等核心信息。

解决方案 #

1. 修正路径一致性 #

确保仓库路径在复制和配置中完全统一：

• 若之前路径错误，重新执行复制命令：

rsync -av ~/.ivy2/cache/ /opt/sbt-repo/ivy/

• 更新~/.sbt/repositories中的配置：

[repositories]
  local
  ivy-cache-repo: file:///opt/sbt-repo/ivy/, [organizationPath]/[module]/[type]s/[artifact]-[revision].[ext]

这里[organizationPath]会自动将组织名的点替换为斜杠，完美匹配Ivy缓存的目录结构。

2. 确保缓存包含完整元数据 #

重新执行项目的update任务，强制下载所有依赖的元数据到Ivy缓存：

sbt update

再重新复制缓存到本地仓库路径，确保ivy.xml或pom.xml文件被同步。

3. 验证与调试 #

• 检查本地仓库中构件的路径是否匹配模式，比如org.scala-lang:scala-library:2.12.17应存在于/opt/sbt-repo/ivy/org/scala-lang/scala-library/jars/scala-library-2.12.17.jar，且同一目录下应有ivy-2.12.17.xml元数据文件。
• 启动SBT时添加-debug参数，查看依赖解析日志，确认SBT是否正确访问本地仓库，以及具体错误原因：

sbt -debug

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