记一次线上API调用失败的排查过程：从405到时间同步

最近在开发一个代码审查工具时，遇到了一个有意思的问题。本地测试一切正常，但调用线上API时却一直失败。整个排查过程挺有意思的，记录下来分享给大家。

我们团队开发了一个内部的代码审查系统，前端使用React，后端是Node.js + Koa框架。最近在开发一个CLI工具，需要调用后端API上传代码审查报告。

本地开发时，CLI工具调用本地服务一切正常： POST http://localhost:34789/document/createCodeReviewDocument 返回 200 OK

但调用线上服务时，却返回了405错误： POST gw.example.com/document/cr... 返回 405 Method Not Allowed

首先怀疑是路由配置问题。查看后端代码发现，我们的路由分为公有路由和私有路由：

但通过浏览器开发者工具发现，线上其他接口都是通过 /api/* 访问的。原来是Nginx做了路由转发：

bash 复制代码

location /api/ {
    proxy_pass http://backend/;
}

第一个坑：线上需要加 /api 前缀，而本地不需要。

修复URL后，405错误解决了，但又出现了新问题：

bash 复制代码

{
  "success": false,
  "errorCode": 40403,
  "errorMsg": "{\"code\":9999}"
}

9999是我们系统的默认错误码，说明出现了未知异常。为了定位问题，我临时修改了错误处理代码，让它返回详细错误信息：

bash 复制代码

} catch (error) {
  // 临时添加详细错误信息
  throw new CodedError(error.message || '系统错误')
}

重新部署后，发现本地连接生产环境会报数据库连接超时。这很正常，因为阿里云RDS有IP白名单限制。

但奇怪的是，其他接口（如 getProjectList）能正常返回数据，说明线上服务是能访问数据库的。那问题出在哪里？

最后实在没办法，只能登录服务器查看日志。PM2的日志暴露了真正的问题：

bash 复制代码

RequestTimeTooSkewedError: The difference between the request time and the current time is too large.

原来是服务器时间不同步！

阿里云OSS有个安全机制：请求时间与服务器时间差不能超过15分钟。我们的服务器时间慢了20多分钟。

解决方案

解决方法很简单，同步服务器时间：

同步时间

bash 复制代码

ntpdate ntp.aliyun.com

bash 复制代码

echo "*/30 * * * * /usr/sbin/ntpdate ntp.aliyun.com" >> /var/spool/cron/root

bash 复制代码

pm2 restart all

经验总结

这次问题虽然最后解决很简单，但排查过程还是学到不少东西。特别是时间同步这种基础设施问题，平时不注意，出问题的时候还真不容易想到。

PS: 感谢团队小伙伴们的支持，特别是运维同学提供的服务器权限。