React+TypeScript项目本地仅报@typescript-eslint/no-explicit-any警告，Vercel部署报错求助

问题根源 #

本地开发时@typescript-eslint/no-explicit-any仅作为警告存在，不影响构建，但Vercel部署环境会将ESLint警告强制转为错误，导致编译失败。这通常是因为生产构建流程（Vercel默认配置或项目自定义脚本）开启了"警告即错误"的校验规则。

具体修复方案 #

方案1：调整ESLint规则，允许any类型（快速解决） #

直接修改eslintrc.json，将@typescript-eslint/no-explicit-any规则设为警告或关闭：

{
  "extends": [
    "standard",
    "prettier",
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended"
  ],
  "plugins": ["@typescript-eslint", "simple-import-sort"],
  "rules": {
    "@typescript-eslint/no-unused-vars": "error",
    "simple-import-sort/imports": "error",
    "@typescript-eslint/no-explicit-any": "warn" // 设为警告，或改为"off"完全关闭
  }
}

方案2：修复代码中的any类型（长期规范） #

逐个替换代码里的any为具体类型或unknown：

• 如果能明确类型，直接定义（比如string、number或自定义接口）
• 如果无法确定具体类型，用unknown替代any，后续使用时通过类型收窄处理

方案3：检查Vercel构建脚本配置 #

查看项目package.json中的build命令，若包含--max-warnings 0参数，会将所有警告转为错误。可以移除该参数：

{
  "scripts": {
    "build": "react-scripts build" // 移除--max-warnings 0
  }
}

方案4：调整Webpack生产构建的ESLint配置 #

若项目自定义了Webpack配置，检查是否使用了eslint-webpack-plugin并设置了failOnWarning: true，将其改为false：

const ESLintPlugin = require('eslint-webpack-plugin');

module.exports = {
  plugins: [
    new ESLintPlugin({
      failOnWarning: false, // 生产构建不因为警告终止
      failOnError: true
    })
  ]
};

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