Nitro.js 项目在Netlify部署中的缓存策略优化指南

问题背景

在使用Nitro.js构建应用并部署到Netlify平台时，开发者遇到了一个关于缓存策略的配置问题。具体表现为：当使用netlify_builder预设时，swr（Stale-While-Revalidate）缓存设置无法正常工作，导致API路由返回405方法不允许的错误。

技术分析

缓存策略失效原因

在Nitro.js 2.10.4版本中，当使用netlify_builder预设时，系统会忽略routeRules中配置的swr: false设置。这是因为Netlify的On-Demand Builders功能对HTTP方法有特殊限制，默认只接受GET请求。

解决方案演进

1. 传统方案：早期版本中，开发者需要使用netlify_builder预设，并手动配置缓存规则
2. 现代方案：从Nitro.js 2.10.0版本开始，引入了对Netlify Functions v2格式的支持，自动添加了durable缓存控制头，这是Netlify推荐的新方法

最佳实践建议

配置推荐

开发者应优先使用主netlify预设而非netlify_builder预设。这一改变可以带来显著的性能提升（从500ms降至50ms），同时确保API端点正常工作。

配置示例

在项目配置中，建议采用以下方式：

// nitro.config.ts
export default defineNitroConfig({
  preset: 'netlify',
  routeRules: {
    '/api/**': { 
      cache: false,
      swr: false 
    },
  }
})

未来版本规划

Nitro.js团队计划在v3版本中完全移除netlify_builder预设，因为：

1. 现代Netlify部署已不再需要此预设
2. 主netlify预设提供了更好的功能和性能
3. 简化配置选项可以减少开发者困惑

性能优化效果

采用新配置后，开发者可以观察到：

• API响应时间显著降低（约90%的改善）
• 所有HTTP方法正常工作（GET/POST等）
• 更符合Netlify平台的最佳实践

结论

对于使用Nitro.js并部署到Netlify的开发者，应优先使用主netlify预设，避免使用即将被废弃的netlify_builder预设。这一改变不仅能解决405方法不允许的问题，还能显著提升应用性能。团队将在未来版本中简化这一配置，为开发者提供更清晰的部署体验。