SST 部署 NextJS 12.x 项目中 API 路由无数据返回问题解析

问题现象

在使用 SST(Serverless Stack) 部署 NextJS 12.x 项目时，开发人员遇到了一个特殊问题：API 路由能够被正常调用并返回正确的 HTTP 状态码(如 200 或 500)，但响应体中却没有包含任何 JSON 数据。这与之前使用 Serverless Components 部署时的行为不同，在之前的部署中 API 功能完全正常。

架构差异分析

通过对比两种部署方式的架构，可以发现几个关键差异点：

1. Lambda 函数分布：在 Serverless Components 部署中，存在独立的默认 Lambda 和 API Lambda；而在 SST 部署中，所有请求都通过默认 Lambda 处理。

2. 边缘函数：SST 部署后，在 CloudFront 中观察不到明显的边缘函数配置，这可能影响请求处理流程。

根本原因

经过深入排查，发现问题源于 Sentry 监控工具与 OpenNext 框架的兼容性问题。当项目中同时使用这两个工具时，会导致 API 路由的响应体数据丢失，尽管状态码仍能正确返回。

解决方案

解决此问题的核心方法是：

1. 检查 Sentry 配置：确保 Sentry 的初始化配置不会干扰正常的 API 响应流程。

2. 调整中间件顺序：如果使用了自定义中间件，确保数据处理的中间件在错误监控中间件之前执行。

3. 隔离测试：可以暂时移除 Sentry 集成进行测试，确认是否是兼容性问题导致。

最佳实践建议

对于使用 SST 部署 NextJS 项目的开发者，建议：

1. 版本兼容性检查：特别是使用较旧版本的 NextJS(如 12.x)时，要特别注意与现代部署工具的兼容性。

2. 监控工具集成：在引入 APM 或错误监控工具时，应在开发环境充分测试所有功能。

3. 渐进式迁移：从 Serverless Components 迁移到 SST 时，建议采用渐进式策略，逐步验证各功能模块。

总结

这个问题展示了在 Serverless 架构迁移过程中可能遇到的微妙兼容性问题。虽然表面现象是 API 无数据返回，但根本原因却涉及监控工具与部署框架的交互。这提醒开发者在架构迁移时，不仅要关注核心功能，还需要注意辅助工具的集成影响。