共享主机部署非静态Nuxt.js应用启动失败、无启动文件问题求助

核心问题解答 #

1. Nuxt应用存在明确的启动文件，服务商“没有启动文件”的判断有误 #

根据你使用的Nuxt版本不同，启动文件路径有区别：

• Nuxt2版本：启动文件路径为./node_modules/nuxt/bin/nuxt-start，也可以在项目根目录新建自定义启动脚本start.js，写入内容require('nuxt-start')后填写该脚本路径即可
• Nuxt3版本：本地执行npm run build后会生成.output目录，启动文件路径为./.output/server/index.mjs

2. 共享主机部署Nuxt难度更高的说法属实 #

Nuxt的非静态部署（SSR/ISR模式）属于Node.js应用，需要长期运行Node进程、配置端口映射、进程守护，而绝大多数共享主机默认只适配静态站点、PHP这类无需持久进程的程序，很多共享主机还存在Node版本不兼容、进程自动回收、端口权限限制等问题，确实会提升部署难度。

3. 能否在当前主机运行Nuxt，取决于主机是否满足以下3个前提： #

• 支持的Node.js版本符合你使用的Nuxt版本要求（Nuxt3要求Node.js ≥16，Nuxt2要求Node.js ≥14）
• 允许长期运行Node.js进程，无自动回收闲置进程的规则
• 支持配置反向代理，将域名请求转发到Nuxt服务监听的端口
  如果以上条件都满足，即可正常部署运行，否则无法在当前共享主机部署非静态的Nuxt应用。

现有报错排查 #

你提供的404报错，是因为当前启动文件配置错误，要么是填写的路径找不到对应启动文件，要么是服务启动后端口没有正确映射，请求没有被转发到Nuxt服务上导致的。

部署注意事项 #

• 建议将文件上传到主机后，在主机终端执行npm install --production重新安装生产依赖，避免本地和主机环境差异导致的运行异常
• 确认Nuxt配置中监听地址设置为0.0.0.0，不要使用默认的127.0.0.1，否则外部请求无法访问到服务
• 启动时使用主机服务商允许的端口，不要使用被限制的端口

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