本地Node.js应用正常，部署到Plesk服务器后无法运行求助

核心排查方向 #

本地正常但Plesk子域名下的httpdocs子目录失效，且日志无报错，重点从路径路由、Plesk部署配置、静态资源加载三个方向入手：

1. 路由与基础路径不匹配 #

你的Express应用所有路由都基于根路径/，但部署到子文件夹后，用户实际请求路径是http://你的子域名.com/子文件夹/，应用仍监听/会导致路由不匹配。

解决方法：

• 给应用添加基础路径前缀，修改代码：

  // 定义子文件夹名称
  const basePath = '/你的子文件夹名';
  
  // 静态资源和路由都加上前缀
  app.use(basePath, express.static(__dirname));
  
  app.get(basePath + '/', (req, res) => {
      res.sendFile(path.join(__dirname + "/index.html"));
  });
  
  app.get(basePath + '/data', (req, res) => {
      // 原逻辑保持不变
      res.json({
          messageCount,
          dbInsertCount,
          tableName: "vivus02",
          mqttTopic: topic,
          nextInsertTime: lastInsertTime + 4 * 60 * 1000,
          noData,
      });
  });
  
  app.post(basePath + '/createTable', (req, res) => {
      // 原逻辑保持不变
  });
  

• 或者在Plesk后台配置反向代理，把子路径直接映射到Node.js应用的端口，让请求/子文件夹/自动转发到localhost:应用端口/。

2. Plesk Node.js部署配置错误 #

Plesk默认不会自动处理子文件夹的Node.js应用映射，需手动调整：

• 进入Plesk后台：网站与域名 > 你的子域名 > Node.js
• 确认文档根目录设置为httpdocs/你的子文件夹
• 检查应用启动文件是否指向你的入口脚本（比如app.js）
• 不要固定监听3000端口，改用Plesk分配的环境变量端口：

  const port = process.env.PORT || 3000;
  app.listen(port, () => {
      console.log(`Server is running on port ${port}`);
  });
  

3. 静态资源加载路径错误 #

本地运行时静态资源（如index.html里的css、js）基于根路径加载，部署到子文件夹后，绝对路径/xxx会变成无效路径。

解决方法：

• 把index.html里的所有资源引用改成相对路径，比如./style.css替代/style.css
• 或者在Express静态资源中间件中明确设置资源路径，确保能被正确访问。

4. 环境变量缺失 #

本地的.env文件可能未上传，或Plesk中未配置对应环境变量，导致MQTT、数据库连接异常（即使日志没报错也需排查）：

• 在Plesk的Node.js配置页，找到环境变量，手动添加所有.env中的变量（DB_HOST、MQTT_BROKER等）
• 确保.env文件已上传到应用根目录，且权限设置为服务器可读。

5. 端口与防火墙问题 #

3000端口可能被占用或被防火墙拦截：

• 用命令netstat -tulpn | grep 3000检查端口占用情况
• 在Plesk防火墙设置中，开放应用使用的端口（优先用Plesk分配的端口，避免手动指定3000）

额外调试技巧 #

如果应用日志无报错，可通过以下方式定位问题：

• 在每个路由开头添加console.log('请求路径:', req.originalUrl)，确认请求是否到达应用
• 查看Plesk的域名访问日志，检查是否有404、502等错误码，判断请求是否被正确转发

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