Next.js 13.4.9通过rewrites转发请求5秒后遇socket hang up错误求助

错误原因 #

• Next.js内置转发超时限制：Next.js服务器端转发请求时，默认沿用Node.js http模块的5秒超时规则，且rewrites配置未暴露该参数的自定义入口。若Spring Boot后端处理请求耗时超过5秒，Next.js会主动断开连接触发此错误。
• 后端响应过慢：Spring Boot接口存在慢查询、IO阻塞或复杂计算等耗时逻辑，无法在5秒内返回响应。
• 中间件/网络限制：Nginx、云服务器防火墙等中间件配置了强制断开长连接的超时规则，截断了超过5秒的请求。

解决办法 #

1. 改用自定义API路由控制超时 #

由于rewrites不支持直接设置超时，可通过自定义API路由替代转发逻辑，手动配置超时时间：

// app/api/proxy/[...path]/route.ts
import { NextResponse } from 'next/server';
import http from 'http';
import https from 'https';

export async function GET(request: Request) {
  const urlObj = new URL(request.url);
  // 拼接后端目标地址，去掉/api/proxy前缀
  const targetUrl = `http://你的SpringBoot地址:端口/${urlObj.pathname.slice(11)}${urlObj.search}`;
  const httpClient = targetUrl.startsWith('https') ? https : http;

  return new Promise((resolve, reject) => {
    const req = httpClient.get(targetUrl, {
      timeout: 30000, // 设置30秒超时，按需调整
      headers: {
        ...request.headers,
        host: '你的SpringBoot地址', // 修正host头避免后端识别异常
      },
    }, (res) => {
      const chunks: Buffer[] = [];
      res.on('data', chunk => chunks.push(chunk));
      res.on('end', () => {
        resolve(new NextResponse(Buffer.concat(chunks), {
          status: res.statusCode,
          headers: res.headers,
        }));
      });
    });

    req.on('timeout', () => {
      req.destroy();
      reject(new Error('请求超时'));
    });

    req.on('error', err => reject(err));
  });
}

// 按需扩展POST/PUT等其他请求方法的处理逻辑

之后客户端请求地址改为/api/proxy/原后端接口路径，不再依赖rewrites转发。

2. 优化Spring Boot后端响应速度 #

• 排查慢查询、IO阻塞问题：给数据库查询加索引、优化复杂计算逻辑，或采用异步处理（如@Async）拆分耗时任务。
• 长任务改用异步回调：后端收到请求后立即返回任务ID，前端通过轮询接口获取最终结果，避免长时间保持连接。

3. 调整中间件超时配置 #

• 若使用Nginx代理，在配置中增加超时参数：

proxy_connect_timeout 30s;
proxy_send_timeout 30s;
proxy_read_timeout 30s;

• 检查云服务器安全组、防火墙规则，取消或延长强制断开长连接的超时限制。

4. 适配Next.js流式响应（GET请求场景） #

若为页面数据请求，可使用Next.js的流式响应（Streaming）或增量静态再生（ISR），避免长时间等待后端响应阻塞页面渲染，降低连接超时概率。

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