如何在build.sbt中添加带请求头私钥的自定义GitLab仓库

sbt没有像Gradle那样直接提供HTTP头认证的快捷配置，需要通过自定义Resolver并添加请求头的方式实现，具体操作如下：

基础硬编码配置 #

直接在Resolver中添加Private-Token请求头，代码示例：

import sbt._
import java.net.URL
import java.util.Collections

resolvers ++= Seq(
  Resolver.url("GitLab Private Repo", new URL("https://你的GitLab仓库地址/api/v4/projects/[项目ID]/packages/maven"))(
    Patterns(
      "[organisation]/[module]/[revision]/[artifact]-[revision](-[classifier]).[ext]"
    )
  ).withHeaders(Collections.singletonMap("Private-Token", "你的私有Token"))
)

推荐安全配置（从环境变量读取Token） #

为避免硬编码Token导致泄露，建议从环境变量中读取Token：

import sbt._
import java.net.URL
import java.util.Collections

// 从环境变量获取Token，不存在则设为空字符串
val gitlabPrivateToken = sys.env.getOrElse("GITLAB_PRIVATE_TOKEN", "")

resolvers ++= Seq(
  Resolver.url("GitLab Private Repo", new URL("https://你的GitLab仓库地址/api/v4/projects/[项目ID]/packages/maven"))(
    Patterns(
      "[organisation]/[module]/[revision]/[artifact]-[revision](-[classifier]).[ext]"
    )
  ).withHeaders(Collections.singletonMap("Private-Token", gitlabPrivateToken))
)

关键注意点 #

• 替换示例中的地址参数：GitLab Maven仓库的标准格式为https://gitlab.com/api/v4/projects/[项目ID或路径编码]/packages/maven，路径编码需将项目路径中的/替换为%2F（比如group/my-project对应group%2Fmy-project）。
• 确保你的私有Token拥有read_package_registry权限，否则会出现认证失败的情况。

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