因Docker构建时依赖问题，无法用Nix构建带Testcontainers的Spring Boot应用

问题背景 #

你在M1 Max MacBook Pro（macOS Sonoma 14.4）的nix-darwin环境中，用配置好Docker的linux-builder构建带Testcontainers集成测试的Java 17 Spring Boot应用，目标是生成含最小化自定义JRE的aarch64 Docker镜像。但执行nix build -vvv .#packages.aarch64-linux.dockerImage时，Testcontainers硬要连接unix:///var/run/docker.sock，而linux-builder里实际可用的Docker sock是unix:///run/user/1000/docker.sock，直接导致构建失败，且无法跳过测试或弃用Testcontainers。

可行解决方案 #

1. 在Nix构建配置中传递正确的DOCKER_HOST #

修改你的flake.nix或相关构建配置文件，在Java项目的测试构建阶段注入正确的环境变量。比如用Gradle构建的话，在mkDerivation中添加：

buildInputs = [ ... ]; # 你的其他依赖项
env = {
  DOCKER_HOST = "unix:///run/user/1000/docker.sock";
  # 若有需要，可额外添加DOCKER_TLS_VERIFY、DOCKER_CERT_PATH等变量
};

如果使用Maven或Gradle包装器，要确保这些环境变量能传递到测试执行的进程中。

2. 配置linux-builder的Docker sock权限 #

在linux-builder的Nix配置里，确保构建用户（UID 1000）有权访问/run/user/1000/docker.sock。可以将用户加入docker组，或开启rootless Docker模式：

services.docker = {
  enable = true;
  rootless = true; # 因为是用户级sock，必须开启rootless模式
  settings = {
    "hosts" = ["unix:///run/user/1000/docker.sock"];
  };
};
users.users.your-build-user = {
  isNormalUser = true;
  extraGroups = ["docker"];
};

注意：rootless Docker需要XDG_RUNTIME_DIR等环境变量在构建环境中正确设置，否则可能无法正常运行。

3. 强制Testcontainers使用指定的Docker主机 #

除了系统环境变量，还可以通过以下方式直接指定Testcontainers的Docker连接路径：

• 在测试代码中添加系统属性：

System.setProperty("testcontainers.docker.host", "unix:///run/user/1000/docker.sock");

• 在Nix构建时给Java测试命令添加JVM参数：

gradleFlags = [
  "-Dtestcontainers.docker.host=unix:///run/user/1000/docker.sock"
];

• 在项目中创建testcontainers.properties文件，写入配置：

docker.host=unix:///run/user/1000/docker.sock

并确保该文件被包含在Nix构建的资源文件列表中。

4. 提前验证Docker连接状态 #

在构建脚本中添加前置检查，提前确认Docker连接正常，避免等到Testcontainers执行时才报错：

preBuild = ''
  echo "检查Docker连接状态..."
  export DOCKER_HOST="unix:///run/user/1000/docker.sock"
  docker info || exit 1
'';

总结 #

通过以上步骤，确保构建环境传递正确的DOCKER_HOST、配置linux-builder的Docker权限、强制Testcontainers使用指定的sock路径，即可解决构建时的连接问题，无需跳过测试或弃用Testcontainers。

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