Node Express MVC项目中，如何在控制器中正确调用Axios库？

阿华AIGC实验室

2026-5-19

在Express控制器中使用Axios的最佳实践

嘿，我来帮你理清这个问题～首先得告诉你：你现在在每个控制器里重复引入Axios的做法其实完全没问题！因为Node.js有模块缓存机制，不管你在多少个文件里require('axios')或者用ES模块的import，它只会加载一次Axios模块，后面的引入都是直接取缓存里的实例，性能上完全不用担心，而且代码可读性也很好，很多成熟的Express项目都是这么做的。

不过如果你觉得重复引入不够优雅，想找更高效的方案，这里有两个靠谱的思路：

1. 自定义Axios实例模块（最推荐）

这种方式比全局挂载更可控，也符合模块化的最佳实践。你可以创建一个单独的文件来配置Axios的全局参数，比如baseURL、拦截器、超时时间等，然后在所有控制器里直接引入这个实例。

举个例子：
首先在项目里新建src/utils/axiosClient.js：

const axios = require('axios');

// 创建自定义Axios实例，统一配置
const axiosClient = axios.create({
  baseURL: 'https://your-api-base-url.com',
  timeout: 10000, // 10秒超时
  headers: {
    'Content-Type': 'application/json',
  },
});

// 可以添加请求拦截器，比如统一携带token
axiosClient.interceptors.request.use((config) => {
  const token = process.env.API_TOKEN;
  if (token) {
    config.headers.Authorization = `Bearer ${token}`;
  }
  return config;
});

// 也可以添加响应拦截器，统一处理错误
axiosClient.interceptors.response.use(
  (response) => response.data, // 直接返回响应数据，简化控制器里的代码
  (error) => {
    // 统一处理请求错误，比如日志记录
    console.error('Axios请求错误:', error);
    return Promise.reject(error);
  }
);

module.exports = axiosClient;

然后在控制器里直接引入这个自定义实例：

const axiosClient = require('../utils/axiosClient');

exports.getSomeData = async (req, res) => {
  try {
    const data = await axiosClient.get('/api/data');
    res.status(200).json(data);
  } catch (err) {
    res.status(500).json({ message: '请求失败', error: err.message });
  }
};

这种方式的好处是：所有控制器共用同一个Axios配置，后续要修改baseURL、添加拦截器或者调整超时时间，只需要改这一个文件就行，维护起来特别方便。

2. 挂载到Express的`app.locals`对象

如果你之前尝试全局挂载没成功，大概率是挂载的方式不对。正确的做法是把Axios挂载到Express app的locals属性上，这样就能在控制器里通过req.app.locals访问到它。

在app.js里：

const express = require('express');
const axios = require('axios');
const app = express();

// 把Axios挂载到app.locals
app.locals.axios = axios;

// 然后正常挂载路由和中间件
app.use('/api', require('./routes/api'));

然后在控制器里：

exports.getSomeData = (req, res) => {
  req.app.locals.axios.get('https://api.example.com/data')
    .then((response) => {
      res.status(200).json(response.data);
    })
    .catch((err) => {
      res.status(500).json({ message: '请求失败', error: err.message });
    });
};

不过这种方式我个人不太推荐，因为控制器里需要通过req.app.locals来访问Axios，不如直接引入自定义实例直观，而且如果后续需要给Axios加全局配置，还是得单独写模块，不如一开始就用自定义实例的方案。