为何WSO2 API Manager中新增REST API资源未同步且调用报404？

• API未完成发布/同步流程：新增资源后仅在Publisher端保存，未执行**发布（Publish）**操作，或者Gateway节点未接收到同步指令。需要确认是否在Publisher完成发布步骤，同时查看api-manager.log验证Gateway同步状态。
• 资源路径/HTTP方法不匹配：新增资源的路径格式错误（比如多余斜杠、路径参数定义失误），或配置的HTTP方法（GET/POST等）与实际调用方法不一致。例如配置/users/{id}却调用/user/{id}，或配置POST但用GET请求，都会触发404。
• Gateway缓存未刷新：Gateway会缓存API定义，新增资源后缓存未及时更新。可通过重启Gateway节点，或在Publisher端执行**重新部署（Redeploy）**API来强制刷新缓存。
• API上下文配置异常：新增资源所属API的上下文（Context）与其他API冲突，或上下文包含特殊字符等非法内容，导致Gateway无法正确路由请求。
• 同步机制故障：Publisher与Gateway之间的心跳连接中断，或数据库中API资源元数据未同步到Gateway注册表（Registry）。可检查registry.log和gateway-worker.log中的错误日志定位同步异常。
• 多租户环境下的租户标识问题：多租户场景中，新增资源时选错租户，或调用请求未携带正确租户标识，导致Gateway无法匹配到对应资源。
• 权限拦截导致的伪404：资源权限配置过严，请求被拦截后返回404而非403。可临时将资源权限设置为允许所有用户访问，验证是否为此原因。

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