CPanel共享主机部署NodeJS Express后仅根路由生效其余路由报500错误

• 1 优先排查CPanel路径重写问题（最高概率） #

  绝大多数CPanel共享主机部署NodeJS应用后仅根路由可访问的问题，都来自Apache没有把⼦路径请求转发给NodeJS进程，默认仅根路径请求会被转发。
  解决方法：在你域名绑定的站点根目录（一般为public_html或自定义的站点根目录）新建/修改.htaccess文件，添加以下重写规则：

  <IfModule mod_rewrite.c>
    RewriteEngine On
    # 转发所有请求到NodeJS应用处理
    RewriteRule ^(.*)$ http://localhost:%{ENV:NODE_PORT}/$1 [P,L]
  </IfModule>
  

  如果你使用的是CPanel官方的NodeJS应用部署工具，还可以添加Passenger配置确保路由解析正常：

  PassengerAppRoot /home/你的CPanel用户名/你的Node应用存放目录
  PassengerStartupFile 你的启动文件名（比如app.js/index.js）
  PassengerNodejs /opt/cpanel/你使用的Node版本路径/bin/node
  

• 2 检查文件路径大小写 #

  本地Windows/macOS系统对文件名大小写不敏感，但CPanel使用的Linux系统大小写完全敏感。请确认：

  • 路由导入语句require('./routes/products')对应的实际文件路径、文件名大小写完全匹配，比如./routes/Products.js/./Routes/products.js都会在环境触发模块找不到错误，返回500
  • 项目中所有静态资源、模块导入的路径大小写都和线上文件一致

• 3 检查依赖与运行时配置 #

  • 登录CPanel的「Node.js 应用」管理面板，找到对应应用，点击「Run NPM Install」重新安装所有依赖，避免线上缺失本地已安装的包
  • 确认你已经将本地的.env文件上传到线上应用的根目录，且文件内的配置项（比如数据库连接地址、API密钥等）已经修改为线上环境可用的配置，配置错误会导致路由处理逻辑抛出异常返回500
  • 可以临时添加全局错误捕获中间件查看具体报错：将以下代码添加到所有路由注册逻辑的后面，访问异常路由时会返回具体错误信息

  app.use((err, req, res, next) => {
    console.error(err.stack);
    res.status(500).send('错误详情：' + err.message);
  });
  

• 4 其他注意事项 #

  你当前代码的路由注册顺序是正确的，/路由在所有子路由之后注册，不会拦截子路由请求；app.listen()未指定端口的写法适配CPanel的NodeJS托管环境（平台会自动注入端口变量），不需要修改。

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