GitLab CI/CD运行chai mocha测试报Error:not supported原因及修复

报错本质是GitLab CI执行环境的Node.js版本不满足Mocha 10.x的最低运行要求，和你查到的旧版Mocha issue场景不匹配：

• 本地开发环境使用Node v16.13.0，符合Mocha 10.x要求的Node >=14.0.0的版本门槛，所以测试可以正常运行
• 从CI报错日志可以看到，流水线实际运行环境是node@v10.16.1、npm@6.9.0，远低于版本要求。Mocha 10内置的ESM模块加载逻辑在Node 10环境下无法执行，直接抛出Error: Not supported错误。
• 你当前的CI配置没有使用项目里编写的Dockerfile作为执行环境，而是直接调用带npm标签的runner的系统原生Node环境，这才导致版本和本地不一致。

方案1：对齐CI与本地的Node版本（推荐） #

修改.gitlab-ci.yml，指定和本地一致的Node 16镜像作为任务执行环境，从根源消除版本差异：

docker build:
  stage: build
  tags:
    - npm
  image: node:16.13.0
  before_script:
    - cd backend
    - npm install
  script:
    - NODE_ENV=test_docker_free npm run test

如果使用的GitLab runner不支持指定执行镜像，需要联系运维将runner上的Node.js版本升级至14.x以上，优先选择和本地一致的16.13.0版本。
如果要完全保证环境一致性，也可以调整CI流程，先构建项目的Docker镜像，再在镜像内部执行测试命令，完全复用Dockerfile里定义的环境，彻底避免本地和CI环境差异问题。

方案2：降级Mocha版本适配旧Node环境（临时方案） #

如果暂时无法修改CI runner的Node版本，可以将Mocha降级到支持Node 10的8.x版本：
在backend目录执行以下命令，锁定Mocha版本：

npm install mocha@8.4.0 --save-exact

提交更新后的package.json和package-lock.json即可让流水线正常运行。注意Mocha 8.x已经停止维护，不会推送安全补丁和功能更新，仅作为临时过渡方案使用。

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