技术项目的推进过程中，常常需要应对各种突发异常。今天就来分享一个典型案例：从遭遇 HTTP 504 错误，到逐步定位根本原因并成功排除故障的完整过程。这里提供一套通用的排错思路，希望能为遇到类似问题的朋友带来启发。
起因：复现操作时遭遇“拦路虎”
昨天尝试复现黄老师公众号文章中描述的操作，没想到一上来就卡了壳。高德 MCP 服务虽然添加成功，界面显示“可使用”，但每次运行都直接抛出 HTTP 504 错误。我在网上搜索了不少帖子，很多都是关于“504 Gateway Timeout: 网关超时”的讨论，但那些解决方案似乎都不适用于当前场景——服务器问题自己无法干预，网络连接也确认正常，一时间陷入了僵局。
后来请教黄老师，他分析问题可能出在高德那边。既然无法控制服务器端，不如先放一放，也许过一晚服务就能恢复。
结果第二天一早再试，504 错误依然顽固。如果真的是服务器故障，未免也太持久了。而且翻遍网络也没看到其他人反映同样的情况——看来问题的根源很可能在我自己这边。
尝试解决：两个关键调整
当时主要做了两件事：
- 将之前创建的高德 Key 删除，重新申请了一个全新的 Key。
- 尝试使用 mcp.so 上提供的配置代码进行接入。
高德官方文档实际上给出了两种配置方案。首先看第一种（SSE 方式）：
{
"mcpServers": {
"amap-amap-sse": {
"url": "https://mcp.amap.com/sse?key=您在高德官网上申请的key"
}
}
}
第二种是 Node.js I/O 方式（也是 mcp.so 推荐的方式）：
{
"mcpServers": {
"amap-maps": {
"command": "npx",
"args": ["-y", "@amap/amap-maps-mcp-server"],
"env": {
"AMAP_MAPS_API_KEY": "您在高德官网上申请的key"
}
}
}
}
完成这两个改动后，高德 MCP 竟然调用成功了！问题虽然暂时解决，但悬念随之而来——究竟是 Key 的问题，还是配置代码的问题？刚才太急于解决问题，两个操作同时进行，无法立刻判断根因。
问题分析：拆解两种接入方式
我将两段配置代码发给豆包，让它做一个对比分析，结果非常清晰：
第一段采用 SSE 模式（远程服务器），本质上只是一个 URL 配置，通过 HTTP 连接到高德的远程 MCP 服务端进行数据交互。优点是技术复杂度低，无需维护本地环境与依赖包；缺点十分明显——高度依赖网络传输，存在延迟风险，网络不稳定时极易引发超时问题。
第二段是 Node.js I/O 模式（本地服务），通过 npx 在本地运行一个 MCP 服务器程序。优点是低延迟、完全可控；缺点是对本地环境有要求，需要安装 Node.js 及相关依赖包，技术门槛相对较高。
这样一来，问题的可能性就非常明确了：SSE 方式依赖远程网络连接，而 504 错误本质上就是网络超时，很可能接入方式本身就是问题的根源。
测试验证：控制变量法锁定真凶
为了快速验证，我单独创建了一个名为“高德 MCP 测试员”的智能体，prompt 很简洁：“你是高德 MCP 调用测试员，目的是测试高德 MCP 是否可以成功被调用，优先采用最简单的实现路径，跑通即可。如果无法成功调用，返回错误信息，并给出原因和解决方案。”
先将配置切回 SSE 方式：
{
"mcpServers": {
"amap-amap-sse": {
"url": "https://mcp.amap.com/sse?key=您在高德官网上申请的key"
}
}
}
第一次测试：失败（返回 400 错误）。
重新确认配置无误后，进行第二次测试：失败（返回 504 错误）。
再将配置切回 Node.js I/O 方式：
{
"mcpServers": {
"amap-maps": {
"command": "npx",
"args": ["-y", "@amap/amap-maps-mcp-server"],
"env": {
"AMAP_MAPS_API_KEY": "您在高德官网上申请的key"
}
}
}
}
测试结果：成功。
结论：接入方式选错了
因此，Trae 接入高德 MCP 服务时出现的 504 错误，根本原因确实是接入方式不当——将 SSE 方式切换为 Node.js I/O 模式后，问题迎刃而解。
简单回顾一下这两种方式的本质区别。
SSE（Server-Sent Events）是一种基于 HTTP 协议的轻量级实时通讯技术，支持服务器向客户端单向推送数据流。它通过持久化 HTTP 连接，让服务器主动将事件流数据发送给客户端。优点是实现简单、支持自动重连；但缺点也同样突出——完全依赖网络通信，容易出现延迟和超时现象。
Node.js I/O 模式则是基于事件驱动、非阻塞 I/O 的本地服务。它不依赖外部网络，数据交互完全在本地完成，响应速度快、延迟极低，非常适合对实时性要求较高的场景。
最终成果展示：https://static-host-x4o0qwe4-yunnantravel.sealoshzh.site/
再重温瑞·达利欧在《原则》中提到的“五步流程实现你的人生愿望”：
- 有明确的目标。
- 找到阻碍你实现这些目标的问题，并且不容忍问题。
- 准确诊断问题，找到问题的根源。
- 规划可以解决问题的方案。
- 做一切必要的事来践行这些方案，实现成果。
流程的背后，体现的是对待问题的态度。凡墙皆是门，解决问题本身就是一件令人快乐的事。
```