Nuxt 3执行generate生成的dist文件无法运行，报useRuntimeConfig错误

问题原因 #

useRuntimeConfig是Nuxt专属的组合式函数，仅能在Nuxt的特定上下文环境中使用（比如页面、组件、插件、自定义composables文件内）。如果你的代码在非Nuxt上下文的文件（比如独立JS/TS脚本、未被Nuxt编译处理的文件）中调用了这个函数，执行yarn generate时会将未被正确处理的函数引用打包进静态文件，而纯浏览器环境中没有该函数的实现，就会触发这个类型错误。

解决步骤 #

• 排查useRuntimeConfig的调用位置：
  确保所有调用都限制在以下Nuxt允许的范围内：
  • pages/目录下的页面组件
  • components/目录下的组件文件
  • plugins/目录下的插件（注意插件运行模式需兼容静态生成）
  • composables/目录下的自定义组合式函数
• 替换非上下文场景的配置获取方式：
  如果需要在非Nuxt上下文的文件中使用配置，可改用app.config.ts定义配置，再通过useAppConfig获取——该API在静态生成时会被正确注入到静态文件中；或者使用publicRuntimeConfig，确保配置能被客户端正常访问。
• 检查第三方依赖：
  若代码中没有直接违规调用，可能是某个第三方依赖错误使用了useRuntimeConfig，尝试更新依赖版本，或查看依赖文档确认是否支持静态生成模式。
• 更新Nuxt到最新版本：
  旧版本Nuxt可能存在静态生成的兼容性bug，执行yarn upgrade nuxt升级到最新稳定版后重新生成静态文件。

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