如何通过Docker Compose并行运行多环境Python测试服务并全局校验执行状态码

这个需求我之前也碰到过！Docker Compose默认的docker-compose up命令确实不会帮你汇总所有服务的退出码——不管容器里的测试结果如何，它本身的退出码往往是0；而--exit-code-from只能指定单个服务的状态，没法做全局校验。不过我们可以通过脚本或者小技巧来实现这个效果，给你两种实用的方案：

方案一：并行运行所有服务，事后校验全局状态 #

这种方案会先让所有测试服务并行跑完，再逐个检查每个容器的退出码，只要有一个服务测试失败，整个脚本就返回非0状态。

你可以写一个简单的Shell脚本（比如命名为run-tests.sh）：

#!/bin/bash

# 1. 后台启动所有测试服务
docker-compose up -d

# 2. 等待所有容器执行完成（需要Docker Compose 1.29+版本支持）
docker-compose wait

# 3. 初始化全局退出码为0
global_exit_code=0

# 4. 遍历所有服务，检查每个容器的退出码
for service_name in $(docker-compose config --services); do
    # 获取当前服务容器的退出码
    container_exit_code=$(docker-compose ps -q "$service_name" | xargs docker inspect -f '{{.State.ExitCode}}')
    echo "✅ 服务 $service_name 执行完成，退出码: $container_exit_code"
    
    # 如果有服务退出码非0，标记全局状态为失败
    if [ "$container_exit_code" -ne 0 ]; then
        echo "❌ 服务 $service_name 测试失败！"
        global_exit_code=1
    fi
done

# 5. 清理测试容器（可选，根据你的需求决定是否保留）
docker-compose down

# 6. 返回全局状态码
exit $global_exit_code

脚本说明： #

• docker-compose up -d：后台启动所有服务，保证测试并行执行
• docker-compose wait：等待所有容器都停止运行（旧版本Compose不支持的话，可以用循环检查docker-compose ps的状态）
• 遍历所有服务时，通过docker inspect获取容器的实际退出码，这才是pytest执行的真实结果
• 最后统一清理容器，并返回全局状态码——只要有一个服务失败，脚本就返回1

方案二：逐个运行服务，实时校验状态 #

如果你不需要完全并行，或者想实时看到每个服务的测试输出，可以用docker-compose run逐个启动服务，然后即时检查退出码：

#!/bin/bash

global_exit_code=0

# 遍历所有要测试的服务名称
for service in python37 python38 python310; do
    echo "=== 开始运行 $service 环境的测试 ==="
    # 启动当前服务并执行测试
    docker-compose run --rm "$service"
    
    # 检查当前服务的退出码
    if [ $? -ne 0 ]; then
        echo "❌ $service 测试失败！"
        global_exit_code=1
    else
        echo "✅ $service 测试通过！"
    fi
done

exit $global_exit_code

方案优势： #

• 可以实时看到每个服务的测试日志，方便调试
• 不需要额外处理容器后台运行和等待的逻辑
• 如果某个服务失败，你可以选择是否继续执行后续服务（比如在失败时直接exit 1中断脚本）

额外注意事项 #

• 如果你用的是旧版本Docker Compose，docker-compose wait可能不支持，这时可以替换成一个循环：

  while docker-compose ps | grep -q "Up"; do
      sleep 2
  done
  

• 可以在脚本中加入docker-compose logs命令，在测试完成后查看所有服务的日志，方便排查失败原因
• 确保你的Dockerfile中CMD或者ENTRYPOINT是直接调用pytest，不要用sh -c包裹，否则可能丢失pytest的真实退出码

备注：内容来源于stack exchange，提问作者Dani