Evolution API v2使用有效实例ID发消息时遭遇404 Not Found问题

我正在使用Evolution API v2通过已存在的实例发送WhatsApp消息，严格按照文档使用端点：POST /message/sendText/{instance}，实际调用的完整端点为：

POST https://aidav1p0-evolution.x268ym.easypanel.host/message/sendText/51d4b3f8-d4af-4420-a8b7-13a452f180a8

已通过/instance/fetchInstances成功获取该实例，确认实例ID有效，但收到404错误：

{
"status": 404,
"error": "Not Found",
"response": {
"message": [
"The \"51d4b3f8-d4af-4420-a8b7-13a452f180a8\" instance does not exist"
]
}
}

已尝试的操作 #

• 验证实例ID和API密钥正确无误；
• 确认实例处于连接状态（connectionStatus: "open"）；
• 尝试在URL中添加/不添加/v2/；
• 确认目标号码为有效的WhatsApp号码。

疑问 #

1. 是否需要在端点中显式包含/v2/？
2. 创建实例后发送消息是否存在延迟？
3. Evolution API v2的消息发送功能是否存在已知问题？

环境信息 #

• 服务器URL：https://aidav1p0-evolution.x268ym.easypanel.host/
• API版本：v2
• 平台：EvolutionAPI WhatsApp (Baileys)

针对疑问的解答 #

1. 是否需要在端点中显式包含/v2/？
   Evolution API v2的标准端点必须包含/v2/前缀，正确的端点格式为POST /v2/message/sendText/{instance}，对应完整调用URL应为：

POST https://aidav1p0-evolution.x268ym.easypanel.host/v2/message/sendText/51d4b3f8-d4af-4420-a8b7-13a452f180a8

建议严格按照该格式重新测试，确保/v2/前缀位置正确。

2. 创建实例后发送消息是否存在延迟？
   实例显示connectionStatus: "open"后，即可立即发送消息，无默认延迟。若出现延迟，多为服务器端实例初始化未完成或网络同步问题，但你的404错误与延迟无关。

3. Evolution API v2的消息发送功能是否存在已知问题？
   基于Baileys的Evolution API v2核心消息功能整体稳定，无广泛报告的普遍性故障。个别问题通常与实例配置、服务器环境、API调用格式错误相关。

额外排查建议 #

• 确认请求头正确携带apikey字段，值为你的API密钥，部分部署环境强制要求该头信息；
• 调用/v2/instance/fetchInstance/{instanceId}接口单独查询目标实例，验证返回的实例ID与调用消息接口时使用的ID完全一致；
• 检查服务器反向代理或路由配置，确保/v2/前缀的请求被正确转发至API服务；
• 尝试调用/v2/instance/restart/{instanceId}重启实例后，再测试消息发送接口。

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