Github Actions构建Docker容器时./configure触发Makefile引导错误

根据你提供的错误日志和Dockerfile内容，这个问题是自动依赖跟踪的makefile片段引导失败导致的，下面是具体的解决方案和排查步骤：

一、快速修复构建错误 #

有两种方法可以绕过这个错误，任选其一即可：

方法1：添加--disable-dependency-tracking参数到configure命令 #

这是错误提示里推荐的最直接方案，禁用自动依赖跟踪功能后，虽然会失去依赖自动更新的便利，但能确保构建流程完成。修改Dockerfile中的configure命令：

# 如果需要传递GIT_BRANCH和GIT_VERSION环境变量
RUN ./configure GIT_BRANCH=$BRANCH GIT_VERSION=$VERSION --disable-dependency-tracking

# 如果不需要传递环境变量，对应你提供的Dockerfile原内容
RUN ./configure --disable-dependency-tracking

方法2：指定MAKE=gmake运行configure #

错误提示提到若未使用GNU make，可显式指定MAKE=gmake。虽然Debian中的make本身就是GNU make，但某些环境下显式指定能规避兼容性问题：

# 带环境变量的版本
RUN ./configure GIT_BRANCH=$BRANCH GIT_VERSION=$VERSION MAKE=gmake

# 不带环境变量的版本
RUN ./configure MAKE=gmake

二、为什么本地构建正常，Github Actions里失败？ #

本地环境和Github Actions的Runner环境存在细微差异：

• Github Actions的容器环境可能使用了不同的make版本或默认配置
• 构建过程中的环境变量、文件权限或临时目录设置不同，触发了本地未遇到的依赖跟踪引导逻辑错误
• 本地构建时可能缓存了部分依赖文件，而Github Actions是全新构建流程，没有缓存兜底

三、查看Github Actions生成的config.log文件 #

要排查具体错误原因，需要获取config.log文件，有两种方式实现：

方式1：在构建失败后上传config.log作为Artifact #

在你的Github Actions workflow文件中，添加失败后的文件上传步骤：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Build Docker image
        id: build-image
        run: |
          # 替换为你的实际构建命令（比如docker或buildah）
          buildah build -t your-image-name .
        continue-on-error: true # 让步骤失败后继续执行后续操作

      - name: Copy config.log from failed container
        if: failure() && steps.build-image.outcome == 'failure'
        run: |
          # 拷贝容器内的config.log到宿主机
          docker cp $(docker ps -q -l):/sphirewall-code/sphirewall-core/config.log ./config.log

      - name: Upload config.log
        if: failure() && steps.build-image.outcome == 'failure'
        uses: actions/upload-artifact@v4
        with:
          name: config-log
          path: ./config.log

方式2：在configure失败时直接打印config.log到构建日志 #

修改Dockerfile中的configure命令，让失败时自动输出日志内容：

RUN ./configure GIT_BRANCH=$BRANCH GIT_VERSION=$VERSION || cat config.log

这样如果configure失败，config.log的完整内容会被打印到Github Actions的构建日志中，无需额外步骤即可查看。

额外建议 #

• 建议将Dockerfile中的基础镜像从debian:latest改为固定版本（比如debian:bookworm），避免后续镜像更新带来的兼容性问题
• 可以尝试在容器内安装make-guile包，补充GNU make的依赖跟踪相关组件，看是否能解决根本问题

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