GitHub Actions中Docker化Django服务连接被拒绝问题求助

1. 等待Django服务器完全就绪 #

GitHub Actions运行环境的资源通常比本地有限，容器启动后Django服务器需要更长时间完成初始化。直接执行curl可能在服务器未就绪时发起请求，导致连接拒绝。

解决方式： #

在curl前加入等待逻辑，或者调整curl参数使其重试连接拒绝的场景：

• 方式一：用循环轮询等待服务器就绪

- name: Check Blawx Heartbeat
  run: |
    # 最多等待60秒，每5秒检查一次
    for i in {1..12}; do
      RESPONSE_CODE=$(docker exec -t nrcan-map-blawx-1 curl -s -o /dev/null -w "%{http_code}" "localhost:8000/")
      if [[ "$RESPONSE_CODE" =~ ^2[0-9]{2}$ || "$RESPONSE_CODE" == "404" ]]; then
        echo "Django server is up"
        exit 0
      fi
      echo "Waiting for server... ($i/12)"
      sleep 5
    done
    echo "Server failed to start within 60 seconds"
    exit 1

• 方式二：修改curl参数，让它重试连接拒绝的情况

docker exec -t nrcan-map-blawx-1 curl --retry 5 --retry-connrefused --retry-delay 2 -X GET "localhost:8000/"

2. 确认Django服务器绑定地址 #

确保Django的启动命令绑定的是0.0.0.0而非127.0.0.1。虽然本地容器内访问localhost没问题，但如果Dockerfile中启动命令是：

CMD ["python", "manage.py", "runserver", "127.0.0.1:8000"]

在资源受限的GitHub Actions环境中可能出现启动异常。建议修改为监听所有接口：

CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

检查你引用的blawx项目Dockerfile是否设置了正确的绑定地址。

3. 固定容器名称避免匹配错误 #

Docker Compose默认容器名称格式为[当前目录名]-[服务名]-[序号]，GitHub Actions中checkout后的目录名是仓库名称，若本地目录名与仓库名不一致，会导致docker exec命令指向错误容器，进而出现连接拒绝。

解决方式： #

在docker-compose.yml中显式指定容器名称：

services:
  blawx:
    container_name: blawx-server
    build: https://github.com/Lexpedite/blawx.git#v1.3.40-alpha
    ports: 
      - "8000:8000"
    expose:
      - 8000
    volumes:
      - ./blawx/fixtures:/app/blawx/blawx/fixtures/nrcan-map

然后在GitHub Actions中使用这个固定名称执行curl：

docker exec -t blawx-server curl --retry 5 --retry-connrefused -X GET "localhost:8000/"

4. 查看容器日志定位启动问题 #

在GitHub Actions中添加步骤，查看容器内的Django日志，确认服务器是否正常启动：

- name: Check Blawx Container Logs
  run: docker logs nrcan-map-blawx-1

通过日志可以直接排查服务器启动失败、配置错误等核心问题。

5. 宿主机curl空响应的补充说明 #

GitHub Actions宿主机执行curl localhost:8000/得到错误码52（空响应），本质是容器内服务器未就绪导致端口映射无有效响应。解决上述服务器就绪问题后，该现象会同步改善。

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