Nuxt3构建启动后报错：找不到pinia-orm/decorators模块

问题场景 #

集成Pinia和Pinia-ORM的Nuxt3 SSR项目，nuxt dev启动开发服务正常，但执行nuxt build后用nuxt start启动，请求页面会抛出500错误，日志如下：

[nuxt] [request error] [unhandled] [500] Cannot find module '/home/workspace/.output/server/node_modules/pinia-orm/dist/decorators' imported from /home/workspace/.output/server/chunks/app/server.mjs
  at new NodeError (node:internal/errors:393:5)  
  at finalizeResolution (node:internal/modules/esm/resolve:323:11)  
  at moduleResolve (node:internal/modules/esm/resolve:916:10)  
  at defaultResolve (node:internal/modules/esm/resolve:1124:11)  
  at nextResolve (node:internal/modules/esm/loader:163:28)  
  at ESMLoader.resolve (node:internal/modules/esm/loader:837:30)  
  at ESMLoader.getModuleJob (node:internal/modules/esm/loader:424:18)  
  at ModuleWrap.<anonymous> (node:internal/modules/esm/module_job:76:40)  
  at link (node:internal/modules/esm/module_job:75:36)

已尝试的方案：

• 删除缓存和Nuxt生成文件后重新构建
• 将@pinia/nuxt和@pinia-orm/nuxt移至package.json的devDependencies（不符合文档要求）
• 同时安装pinia和@pinia/nuxt，或仅安装@pinia/nuxt
• 尝试用npm强制安装pinia（当前项目使用yarn）
• 删除nuxt.config.ts中的autoImports配置

环境信息：

• Node.js 18.10.0
• Nuxt 3.3.3、Nitro 2.3.2、Vite 4.2.1

依赖配置（package.json）：

"dependencies": {
    ...
    "@pinia-orm/nuxt": "^1.1.7",
    "@pinia/nuxt": "0.4.7",
    ...
    "nuxt": "^3.3.2",
    "pinia-orm": "^1.5.1",
},
"devDependencies": {
    ...
}

Nuxt配置（nuxt.config.ts）：

export default defineNuxtConfig({
    ssr: true,
    ...
    modules: [
        ...
        [
            '@pinia/nuxt',
            {
                autoImports: [
                    'defineStore',
                    ['defineStore', 'definePiniaStore'],
                ],
            }
        ],
        '@pinia-orm/nuxt',
    ],
    ...
})

解决方法 #

1. 配置Nitro将pinia-orm内联到服务端构建 #

在nuxt.config.ts中添加Nitro外部依赖配置，强制将pinia-orm包含在服务端打包产物中，避免被标记为外部依赖导致运行时找不到模块：

export default defineNuxtConfig({
  // ...现有配置
  nitro: {
    externals: {
      inline: ['pinia-orm']
    }
  }
})

2. 清理依赖并确保版本兼容 #

执行以下命令清理缓存和旧依赖，重新安装后构建：

yarn cache clean
rm -rf node_modules .output .nuxt
yarn install
yarn build
yarn start

同时确认版本匹配：@pinia/nuxt@0.4.7对应Pinia主版本^2.0.0，pinia-orm@1.5.1与该版本兼容，若问题仍存在可尝试升级到同系列最新稳定版。

3. 规范Pinia-ORM装饰器导入方式 #

如果项目使用了@Model、@Field等装饰器，避免直接导入pinia-orm/dist/decorators，改用官方推荐的导入路径：

import { Model, Field, Str } from 'pinia-orm'

错误的导入路径会导致构建时无法正确解析模块。

4. 简化Pinia自动导入配置 #

可尝试保留Pinia默认自动导入，简化模块配置：

export default defineNuxtConfig({
  modules: [
    '@pinia/nuxt',
    '@pinia-orm/nuxt'
  ],
  pinia: {
    autoImports: ['defineStore', 'acceptHMRUpdate']
  }
})

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