Vercel Serverless Functions中axios导入兼容问题求助

数据老陈

2026-7-27

Vercel Serverless Functions 中 Axios 跨环境兼容问题解决方案

问题背景

在Vercel Serverless Functions中使用Axios时，本地开发环境（Node 14.15.1/18.15.0）与Vercel部署环境（Node 18.x）存在导入方式兼容性冲突：

直接导入axios：本地运行正常，但部署后提示找不到/var/task/node_modules/axios/dist/node/axios.cjs模块
直接导入axios/dist/node/axios.cjs：部署后正常，但本地开发报ERR_PACKAGE_PATH_NOT_EXPORTED错误

通用解决方案

方案一：环境区分动态导入

利用Vercel自动注入的VERCEL环境变量（部署时该变量值为1），动态选择适配当前环境的导入方式：

CommonJS 写法

let axios;
if (process.env.VERCEL) {
  // Vercel 部署环境
  axios = require('axios/dist/node/axios.cjs');
} else {
  // 本地开发环境
  axios = require('axios');
}

ES 模块动态导入写法

let axios;
if (process.env.VERCEL) {
  axios = (await import('axios/dist/node/axios.cjs')).default;
} else {
  axios = (await import('axios')).default;
}

方案二：降级 Axios 版本

Axios v1.x 系列的ESM/CJS混合导出逻辑在Vercel Serverless环境存在兼容问题，降级到v0.27.x版本后，直接使用import axios from 'axios'即可同时适配本地开发与部署环境：

npm install axios@0.27.2

方案三：覆盖 Axios 的导出配置（临时方案）

通过package.json的overrides（npm 8.3+）或resolutions（Yarn）配置，强制让本地环境识别axios/dist/node/axios.cjs路径：

{
  "overrides": {
    "axios": {
      "exports": {
        ".": "./index.js",
        "./dist/node/axios.cjs": "./dist/node/axios.cjs"
      }
    }
  }
}