Java代码执行Docker容器内chmod命令未生效的问题排查

问题描述 #

尝试通过Java代码给Docker容器内的/tmp/dump.sh添加执行权限，代码如下：

String cmd = "docker exec -it " + POSTGRES_CONTAINER_NAME + " bash -c 'chmod +x /tmp/dump.sh'";

Runtime rt = Runtime.getRuntime();
Process pr = rt.exec(cmd);

BufferedReader br = new BufferedReader(new InputStreamReader(pr.getInputStream()));
for (String line = br.readLine(); line != null; line = br.readLine()) {
  LOGGER.debug("L:{}", line);
}

执行后发现权限未设置成功，且无任何输出。手动在命令行执行相同命令则可以正常设置权限：

docker exec -it postgres_intm bash -c 'chmod +x /tmp/dump.sh'

权限对比结果：

# Java执行后查看
docker exec -it postgres_intm bash -c "ls -la /tmp/dump.sh"
-rw-r--r-- 1 root root 134 Jun  4 20:59 /tmp/dump.sh

# 手动执行后查看
docker exec -it postgres_intm bash -c "ls -la /tmp/dump.sh"  
-rwxr-xr-x 1 root root 134 Jun  4 20:59 /tmp/dump.sh

错误原因分析 #

1. -it参数不适用于非交互式环境：
   docker exec -it中的-i（交互式）和-t（分配TTY）是为命令行交互式场景设计的，而Java的Runtime.exec运行在非交互式环境中，Docker无法分配TTY会导致命令静默失败，无任何输出。

2. 命令字符串的引号解析问题：
   Java代码中用单引号嵌套包裹bash -c的命令参数，Runtime.exec调用shell解析命令时，会破坏原有的命令结构，导致chmod命令没有被正确传递到容器内部。

3. 未读取错误输出流：
   原代码只读取了标准输出流，命令执行失败的错误信息会输出到错误流，导致无法排查问题根源。

修复方案 #

方案1：移除-it参数并调整命令格式 #

去掉-it参数，同时调整引号转义方式，确保命令被正确解析：

String cmd = "docker exec " + POSTGRES_CONTAINER_NAME + " bash -c \"chmod +x /tmp/dump.sh\"";

Runtime rt = Runtime.getRuntime();
Process pr = rt.exec(cmd);

// 同时读取标准输出和错误输出，排查问题
BufferedReader stdoutReader = new BufferedReader(new InputStreamReader(pr.getInputStream()));
BufferedReader stderrReader = new BufferedReader(new InputStreamReader(pr.getErrorStream()));

String line;
while ((line = stdoutReader.readLine()) != null) {
  LOGGER.debug("STDOUT: {}", line);
}
while ((line = stderrReader.readLine()) != null) {
  LOGGER.debug("STDERR: {}", line);
}

// 等待命令执行完成并获取退出码
int exitCode = pr.waitFor();
LOGGER.debug("命令执行退出码: {}", exitCode);

方案2：使用ProcessBuilder传递参数数组（推荐） #

ProcessBuilder可以直接传递命令参数数组，完全避免shell解析引号、空格等问题，执行更稳定：

import java.util.Arrays;

// 构造命令参数数组，无需处理引号
List<String> cmdArgs = Arrays.asList(
    "docker", "exec",
    POSTGRES_CONTAINER_NAME,
    "bash", "-c", "chmod +x /tmp/dump.sh"
);

ProcessBuilder pb = new ProcessBuilder(cmdArgs);
pb.redirectErrorStream(true); // 将错误流合并到标准流，统一读取
Process pr = pb.start();

BufferedReader outputReader = new BufferedReader(new InputStreamReader(pr.getInputStream()));
String line;
while ((line = outputReader.readLine()) != null) {
  LOGGER.debug("输出内容: {}", line);
}

int exitCode = pr.waitFor();
LOGGER.debug("命令执行退出码: {}", exitCode);

关键注意点 #

• 非交互式执行docker exec时必须移除-it，否则命令必然失败。
• 使用ProcessBuilder传递参数数组是执行外部命令的最佳实践，能避免绝大多数shell解析问题。
• 必须读取错误输出流，才能获取命令执行失败的具体原因，方便快速排查。

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