Nuxt3构建报错：Cannot read properties of undefined (reading 'options')求助

问题原因 #

你遇到的错误是因为**@nuxtjs/axios是专为Nuxt2开发的模块，完全不兼容Nuxt3**。哪怕你没手动配置这个模块，只要项目中安装了它，Nuxt3在初始化时就会加载该模块，而模块内的代码依赖Nuxt2的上下文环境，找不到预期的options对象，从而抛出错误。

解决方案 #

1. 卸载不兼容的旧模块

先把Nuxt2版本的axios模块从项目中移除：

npm uninstall @nuxtjs/axios
# 若使用yarn则执行：
yarn remove @nuxtjs/axios

2. 选择Nuxt3兼容的HTTP方案

方案一：使用Nuxt3内置的$fetch（推荐）

Nuxt3内置了基于ofetch的$fetch方法，无需额外安装，直接在组件或页面中使用即可，完美适配服务端渲染和客户端场景：

// 在页面或组件的<script setup>中
const data = await $fetch('https://api.example.com/your-endpoint')

方案二：手动集成原生axios

如果习惯使用axios，可以手动安装并通过Nuxt插件集成：

• 安装axios：

npm install axios
# 或
yarn add axios

• 在项目根目录创建plugins/axios.ts（或.js）文件，配置axios实例：

import axios from 'axios'

export default defineNuxtPlugin(() => {
  const axiosInstance = axios.create({
    baseURL: 'https://your-api-base-url.com',
    // 可添加headers、超时时间等其他配置
  })

  return {
    provide: {
      axios: axiosInstance
    }
  }
})

• 在组件/页面中使用：

const { $axios } = useNuxtApp()
const response = await $axios.get('/your-api-path')

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