基于自定义Dockerfile的GitHub Actions模块找不到错误解决方法

问题背景 #

尝试通过GitHub Action运行单个Node.js脚本（index.js），配置Dockerfile的WORKDIR /github/workspace/以匹配GitHub Actions的默认工作目录，但运行时出现MODULE_NOT_FOUND错误，提示找不到/github/workspace/index.js；尝试在Dockerfile中直接复制index.js到该路径后，又出现Error: Resource not accessible by integration权限错误。

用户提供的Dockerfile：

FROM node:lts

COPY package*.json ./

RUN npm install

COPY index.js /github/workspace/index.js
RUN ["chmod", "+x", "/github/workspace/index.js"]

RUN ls
ENTRYPOINT ["node", "/github/workspace/index.js"]

解决方案 #

1. 避免硬编码/github/workspace路径 #

GitHub Actions在运行容器时会动态挂载仓库工作目录到容器的/github/workspace，构建镜像时复制文件到该路径会被挂载的内容覆盖，导致运行时找不到文件。应将文件放到容器内的独立目录（比如/app）：

修改后的Dockerfile：

FROM node:lts

# 设置独立工作目录，避免和GitHub挂载目录冲突
WORKDIR /app

COPY package*.json ./
RUN npm install

COPY index.js ./
RUN chmod +x index.js

# 直接运行当前目录下的脚本，无需硬编码路径
ENTRYPOINT ["node", "index.js"]

2. 解决权限错误（Resource not accessible by integration） #

该错误源于容器运行时的权限问题，可通过两种方式解决：

方案一：在Workflow中配置权限

在你的GitHub Action workflow文件（如.github/workflows/main.yml）中添加权限声明，根据脚本需求调整权限范围：

jobs:
  run-node-script:
    runs-on: ubuntu-latest
    # 配置必要的权限，比如仅读取仓库内容
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - name: Build and run container
        run: |
          docker build -t node-action .
          docker run node-action

方案二：Dockerfile中切换到非root用户

官方node镜像自带node非root用户，切换后可避免权限冲突：

FROM node:lts

WORKDIR /app

COPY package*.json ./
RUN npm install

COPY index.js ./
RUN chmod +x index.js

# 切换到node用户运行
USER node

ENTRYPOINT ["node", "index.js"]

3. 若需访问仓库文件，正确挂载工作目录 #

如果脚本需要读取仓库中的其他文件，在运行容器时将GitHub工作目录挂载到容器的工作目录：

docker run -v $GITHUB_WORKSPACE:/app node-action

这样容器内的/app目录就会和仓库的工作目录同步，脚本可以访问所有仓库文件。

关键原因说明 #

• /github/workspace是GitHub Actions的动态挂载目录，构建镜像时写入的内容会被运行时的挂载覆盖，因此构建阶段不要操作该路径。
• Resource not accessible by integration通常是容器以root用户运行时，访问GitHub资源（如仓库内容）的权限不足导致，切换非root用户或配置Workflow权限即可解决。

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