将Nuxt3从SSR改为SPA（ssr:false）时出现Proxy错误求助

问题详情 #

将Nuxt 3.4.0应用改为SPA模式（设置ssr: false）后，启动时出现以下错误：

Error while mounting app: TypeError: `target` argument of Proxy must be an object, got undefined
[entry.js:58:13](http://localhost:3000/_nuxt/Users/gitamgadtaula/Desktop/work/freelance/glrtec/frontend/node_modules/nuxt/dist/app/entry.js)

当前nuxt.config.ts配置：

// https://nuxt.com/docs/api/configuration/nuxt-config
export default defineNuxtConfig({
 ssr: false,
 app: {
   head: {
     title: "GLRTECH",
     meta: [
       {
         name: "description",
         content: "Your portfolio management in a smart fashion",
       },
     ],
     link: [
       { rel: "icon", href: "/favicon.ico" },
       {
         rel: "stylesheet",
         href: "https://fonts.googleapis.com/icon?family=Material+Icons",
       },
     ],
   },
 },
 imports: {
   // auto importing files from store and composables directory
   dirs: ["stores", "composables"],
 },
 css: ["@/assets/css/style.scss"],
 modules: [
   "@nuxtjs/tailwindcss",
   "@formkit/nuxt",
   "@pinia/nuxt",
   "@vueuse/nuxt",
 ],
 pinia: {
   autoImports: ["defineStore"],
 },
 tailwindcss: {
   viewer: false,
 },
 vite: {
   // plugins: [
   //   // ...
   // ],
 },
});

解决方案尝试 #

1. 排查第三方模块兼容性 #

部分模块在Nuxt 3.4.0的SPA模式下可能存在兼容问题，可先临时注释modules中的@formkit/nuxt，重启项目验证是否报错。若问题消失，需更新该模块至兼容版本，或参考其文档调整SPA模式下的配置。

2. 清理项目缓存 #

缓存文件可能导致版本冲突，执行以下命令清理后重新安装依赖：

rm -rf node_modules .nuxt .nitro package-lock.json yarn.lock
npm install
npm run dev

3. 检查自动导入的自定义文件 #

stores和composables目录下的代码若使用了SSR专属API（如useRequestHeaders），在SPA模式下初始化时可能返回undefined，进而引发Proxy错误。需添加客户端环境判断：

// 错误示例
const headers = useRequestHeaders()

// 修正后
if (process.client) {
  const headers = useRequestHeaders()
  // 后续逻辑
}

4. 降级Nuxt版本 #

若为Nuxt 3.4.0的版本bug，可尝试降级至3.3.x版本：
修改package.json中的nuxt版本为3.3.4，重新安装依赖后启动测试。

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