Hexo项目升级后本地Docker构建正常，GitLab CI报EISDIR错误

问题背景 #

Hexo项目升级到6.3.0后，本地macOS和Docker构建均正常，但在GitLab CI环境下，使用Node.js 14及以上版本执行hexo generate时会触发EISDIR: illegal operation on a directory, open '<directory>'错误。仅Node.js 12能正常运行，但新版Hexo要求Node.js 14+，版本兼容矛盾无法直接绕过。

可行解决方向 #

1. 修复容器内文件权限 #

GitLab CI的Docker-in-Docker环境中，复制到容器的文件/目录权限可能异常，导致Node.js文件系统调用失败。修改Dockerfile，切换到node用户运行：

FROM node:18.15.0-alpine3.16

WORKDIR /app
COPY . .

# 将目录权限授予node用户，避免root权限冲突
RUN chown -R node:node /app
USER node

RUN apk update && apk add --no-cache yarn

CMD ["sh", "-c", "yarn install && yarn run generate && ls -l public"]

2. 强制清理Hexo缓存 #

CI环境中残留的旧缓存（db.json、node_modules/.cache）可能与新版Node.js不兼容，在生成前添加清理步骤：

• 修改package.json的scripts：

{
  "scripts": {
    "generate": "rm -rf db.json node_modules/.cache && ./node_modules/hexo/bin/hexo generate"
  }
}

• 或直接在Dockerfile的CMD中加入清理：

CMD ["sh", "-c", "yarn install && rm -rf db.json node_modules/.cache && yarn run generate && ls -l public"]

3. 检查Hexo路径配置 #

确认_config.yml中的public_dir、source_dir等路径配置正确，避免指向不存在的目录或被误设为文件路径：

public_dir: public
source_dir: source

确保这些路径在项目中是合法目录。

4. 简化GitLab CI构建流程 #

放弃Docker嵌套构建，直接使用Node.js镜像作为CI执行环境，减少文件系统层级问题：
修改.gitlab-ci.yml：

image: node:18.15.0-alpine3.16

before_script:
  - apk update && apk add --no-cache yarn
  - yarn install

deploy:
  stage: deploy
  only:
    - master
  script:
    - yarn run generate
    - ls -l public

5. 定位具体错误来源 #

启用Hexo调试日志，查看触发错误的具体步骤：
在CI脚本或Dockerfile中添加DEBUG=hexo*环境变量：

DEBUG=hexo* yarn run generate

根据日志定位到出错的插件或代码段，检查是否存在路径处理错误，必要时升级插件或提交问题反馈。

临时妥协方案 #

若上述方法均无效，可临时使用Node.js 12执行生成命令（需安装nvm）：
修改Dockerfile：

FROM node:18.15.0-alpine3.16

WORKDIR /app
COPY . .

RUN apk update && apk add --no-cache yarn nvm
CMD ["sh", "-c", "yarn install && nvm install 12 && nvm use 12 && yarn run generate && ls -l public"]

注意：此方案仅为临时绕过，长期需等待Hexo社区修复版本兼容问题。

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