Travis-CI中mocha+nyc执行npm test报Permission denied如何解决

问题背景 #

搭建集成Travis-CI的NodeJS应用服务端，采用Mocha与NYC支撑测试流程，本地环境测试运行无报错，Travis-CI环境执行失败。

错误输出 #

> server@1.0.0 test /server
> nyc --reporter=lcov npm run run-test "--coverage"
sh: nyc: Permission denied
npm ERR! Test failed.  See above for more details.
The command "docker run repname/server npm test -- --coverage" exited with 1.

原有配置 #

.travis.yml配置 #

sudo: required
services:
  - docker
    
before_install:
  - docker build -t repname/server -f Dockerfile.dev .

script:
  - docker run repname/server npm test -- --coverage

已尝试的无效操作 #

尝试在Travis配置中添加执行权限修改，均未生效：

• 针对NYC赋权：

before_script: chmod 0555 ./node_modules/.bin/nyc
before_script: chmod 0777 ./node_modules/.bin/nyc

• 针对Mocha赋权：

before_script: chmod 0555 ./node_modules/.bin/mocha
before_script: chmod 0555 ./node_modules/.bin/mocha

问题根因 #

所有chmod操作都执行在Travis-CI的宿主机上，但测试命令实际运行在隔离的Docker容器内部，宿主机的文件权限修改完全不会作用到容器内的文件，赋权操作从路径上就没生效。
另外两类常见触发原因：

• Docker构建时直接复制了本地的node_modules目录，二进制文件的执行权限在复制过程中丢失
• 容器内默认使用非root用户运行，依赖安装阶段生成的可执行文件没有对应运行权限

修复方案 #

• 方案1（推荐，长期生效）：在Dockerfile构建阶段固化权限配置
  修改Dockerfile.dev，不要直接复制本地node_modules目录进镜像，在镜像内完成依赖安装并统一配置执行权限，参考配置片段：

  # 替换为你实际使用的Node基础镜像版本
  FROM node:18-alpine
  WORKDIR /server
  # 先复制依赖声明文件，充分利用Docker构建缓存
  COPY package*.json ./
  # 安装依赖，--unsafe-perm避免非root用户下二进制包安装权限异常
  RUN npm install --unsafe-perm=true
  # 复制剩余业务代码
  COPY . .
  # 统一给node_modules下的可执行文件加运行权限，不需要单独针对单个包赋权
  RUN chmod +x ./node_modules/.bin/*
  

• 方案2（快速临时验证）：运行容器时指定root用户执行命令
  修改.travis.yml的script段，启动容器时追加-u root参数用最高权限运行测试：

  script:
    - docker run -u root repname/server npm test -- --coverage
  

避坑提示 #

不要在Travis的宿主机执行环节修改本地node_modules权限，只要测试命令跑在Docker容器内，所有针对宿主机文件的操作都不会影响容器内部环境。

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