cPanel托管Express.js应用访问API端点时遇404错误求助

问题概述 #

在cPanel上托管的Node.js聊天应用，发送POST请求到/chat端点时返回404错误，服务器已确认运行，怀疑路由或cPanel配置问题。

核心错误点 #

1. Express路由路径错误：代码中路由定义使用了完整URL（https://www.mazzn.info/chat），而非Express要求的相对路径
2. 前后端参数不匹配：前端发送的参数名与后端接收的参数名不一致
3. cPanel部署路径与转发配置缺失：未正确设置Node.js应用的启动文件及请求转发规则

修复步骤 #

1. 修正Express路由定义 #

修改server.mjs中的路由，将完整URL替换为相对路径：

// 原错误写法
// app.get('https://www.mazzn.info/chat', (req, res) => {})
// app.post('https://www.mazzn.info/chat', async (req, res) => {})

// 修正后
app.get('/chat', (req, res) => {
  res.send('This is the chat page. You can use it for testing or debugging.');
});

app.post('/chat', async (req, res) => {
  // ... 原有逻辑
});

2. 统一前后端参数名 #

前端发送的参数是message，后端接收的是msgp1，二选一调整：

• 方案一：修改前端fetch的请求体：

// 原代码
// body: JSON.stringify({ message }),

// 修正后
body: JSON.stringify({ msgp1: message }),

• 方案二：修改后端参数接收：

// 原代码
// const { msgp1 } = req.body;

// 修正后
const { message } = req.body;
let messageText = `Answer to this message as a doctor ${message}`;

3. 配置cPanel Node.js应用 #

1. 登录cPanel，打开Node.js应用管理器
2. 确认应用的启动文件设置为public_html/server.mjs
3. 检查端口配置：cPanel会自动分配端口，代码中保留process.env.PORT || 3000即可，不要硬写固定端口
4. 添加public_html/.htaccess文件实现请求转发（替换[你的端口]为cPanel分配的端口）：

RewriteEngine On
# 转发/chat请求到Node服务
RewriteRule ^chat$ http://localhost:[你的端口]/chat [P,L]

4. 验证修复 #

• 重启cPanel上的Node.js应用
• 访问https://www.mazzn.info/chat（GET请求），确认返回测试文本
• 测试前端发送消息功能，检查是否能正常获取聊天机器人响应

额外注意事项 #

• 确保server.mjs中已填写有效的OpenAI API Key，避免后续500错误
• 通过cPanel终端进入public_html目录，执行npm install确保依赖安装完整
• 查看cPanel应用日志，排查是否存在端口占用、模块缺失等其他问题

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