使用ngrok对接SendGrid API遇POST /404错误，Webhook.site可正常工作

1. 补全Node.js服务的POST路由配置 #

出现POST / 404 Not Found的核心原因是你的Glitch项目没有监听根路径的POST请求。以Express框架为例，需在代码中添加对应路由处理：

const express = require('express');
const app = express();

// 解析SendGrid发送的JSON格式请求体
app.use(express.json());

// 处理SendGrid Webhook的POST请求
app.post('/', (req, res) => {
  console.log('收到Webhook数据:', req.body);
  // 必须返回200状态码给SendGrid，否则会触发重试
  res.status(200).send('OK');
});

// 兼容Glitch的端口配置
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`服务运行在端口${PORT}`);
});

如果项目未安装Express，在Glitch终端执行npm install express完成安装。

2. 验证端口与转发匹配 #

从你的ngrok会话信息看，转发目标是localhost:3000，需确保：

• Glitch项目的服务监听端口与ngrok转发目标一致，代码中用process.env.PORT || 3000可兼容Glitch的自动端口分配
• ngrok运行时，Glitch项目处于运行中状态（顶部状态栏显示"Running"），若项目休眠需手动唤醒

3. 检查SendGrid Webhook配置细节 #

• 将SendGrid中的Webhook URL改为https://dff1-35-175-191-91.ngrok.io（优先用HTTPS，避免协议兼容问题）
• 确认已启用需要监听的Webhook事件（如打开、退信、点击等），且请求方法设置为POST
• 通过ngrok的Web界面（http://127.0.0.1:4040）查看请求详情，确认SendGrid是否发送了请求，以及请求路径、方法是否正确

4. 本地测试路由可用性 #

在Glitch终端执行curl命令，验证POST路由是否正常响应：

curl -X POST http://localhost:3000 -H "Content-Type: application/json" -d '{"test": "sample-data"}'

若返回OK及200状态码，说明路由配置正确；若仍返回404，需检查代码中路由的书写是否有误。

内容的提问来源于stack exchange，提问作者Learning Smart Contracts