npm run build在Jenkins执行shell时失败，命令行执行正常求助

1. 核对Node.js/npm版本一致性 #

在本地root终端执行node -v和npm -v，同时在Jenkins的Shell构建步骤里添加这两个命令，对比版本是否一致。版本差异可能导致ESLint对代码规则的校验逻辑不同，比如新版本ESLint对React Hook的依赖检查更严格。

2. 检查ESLint配置文件的完整性 #

• 本地执行npm run lint，确认是否会触发相同的报错。如果本地不报错，检查Jenkins工作目录下的项目文件，确认.eslintrc、.eslintignore是否存在且内容和本地一致。这类配置文件如果没提交到Git，Jenkins拉取的代码就会缺少忽略规则，导致额外的校验报错。
• 查看项目package.json中的eslintConfig字段，确认本地和Jenkins环境的规则是否一致。

3. 对比build命令的执行逻辑 #

打开项目的package.json，检查scripts中的build命令。比如本地的build命令可能隐含了跳过ESLint的参数（如react-scripts build --no-eslint），而Jenkins执行的是未加参数的默认命令，导致触发ESLint校验。

4. 应急：临时跳过ESLint校验 #

如果需要快速让构建成功，可在Jenkins的Shell步骤中修改命令：

# 方法1：通过环境变量关闭ESLint插件
DISABLE_ESLINT_PLUGIN=true npm run build

# 方法2：给build命令添加跳过参数（React项目示例）
npm run build -- --no-eslint

5. 根治：修复ESLint报错 #

从代码层面解决问题，避免后续构建失败：

• useEffect依赖缺失：补全useEffect的依赖数组；如果确实不需要依赖，添加注释// eslint-disable-next-line react-hooks/exhaustive-deps忽略该报错。
• 未使用变量：删除无用变量，或添加/* eslint-disable no-unused-vars */注释，也可在.eslintrc中将no-unused-vars规则设为警告（"no-unused-vars": "warn"），避免阻断构建。

6. 确认执行环境的NODE_ENV #

在Jenkins的Shell步骤中添加echo $NODE_ENV，查看环境变量是否为production。部分项目会根据NODE_ENV调整ESLint规则，生产环境可能放宽校验，而Jenkins环境如果默认是development，会触发更严格的校验。

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