NestJS服务抛出ERR_HTTP_HEADERS_SENT错误，求解决方案

这个错误的核心是同一个请求被多次发送响应，结合你提供的代码，问题出在路由冲突和Middleware逻辑缺陷两个方面，以下是具体排查和修复方案：

问题1：AppMiddleware与AppController的路由冲突 #

你的AppMiddleware已经处理了所有非/api的请求（包括根路径/），但AppController中还存在@Get()路由，会再次尝试发送index.html。当请求根路径时，Middleware先发送了响应，之后Controller又触发一次响应，直接导致ERR_HTTP_HEADERS_SENT。

修复：删除AppController中的root方法，非/api请求完全由Middleware处理：

@Controller()
export class AppController {
  // 移除重复的根路由处理
}

问题2：AppMiddleware内部逻辑可能导致重复响应 #

原Middleware存在两个隐患：

1. 静态文件判断逻辑不准确（用indexOf(ext) > 0会匹配路径中间包含后缀的情况，比如/image.png/xxx）
2. 异步回调中res.sendFile没有检查响应是否已发送，可能在第一次响应后再次发送

修复后的Middleware代码：

@Injectable()
export class AppMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: Function) {
    const url = req.originalUrl;
    
    // 准确判断/api开头的路由，交给后续处理
    if (url.startsWith('/api')) {
      return next();
    }

    // 检查是否为允许的静态文件后缀（仅匹配路径末尾）
    const isStaticFile = allowedExt.some(ext => url.endsWith(ext));
    if (isStaticFile) {
      const filePath = path.resolve(__dirname + `/../gui/${url}`);
      res.sendFile(filePath, (err) => {
        // 仅在响应未发送时处理错误
        if (err && !res.headersSent) {
          res.sendFile(path.resolve(__dirname + '/../gui/index.html'));
        }
      });
      return;
    }

    // 其他情况返回index.html，确保不重复发送
    if (!res.headersSent) {
      res.sendFile(path.resolve(__dirname + '/../gui/index.html'));
    }
  }
}

关键优化点： #

• 用startsWith('/api')替代indexOf('api') === 1，避免误匹配非/api路由
• 用endsWith(ext)替代indexOf(ext) > 0，准确匹配静态文件后缀
• 所有发送响应的逻辑前都检查res.headersSent，确保不会重复发送
• 每个分支处理后加return，阻止后续代码执行

更优方案：使用NestJS官方ServeStaticModule #

自定义Middleware处理静态文件容易出错，推荐使用官方的ServeStaticModule，它会自动处理静态文件和SPA路由（404时返回index.html）：

1. 安装依赖（如果未安装）：

npm install @nestjs/serve-static

2. 在AppModule中配置：

import { ServeStaticModule } from '@nestjs/serve-static';
import { join } from 'path';

@Module({
  imports: [
    ServeStaticModule.forRoot({
      rootPath: join(__dirname, '..', 'gui'), // 静态文件根目录
      exclude: ['/api*'], // 排除所有/api开头的路由
      serveStaticOptions: {
        fallback: 'index.html', // SPA路由 fallback到index.html
      },
    }),
    // 其他模块...
  ],
})
export class AppModule {}

配置完成后，你可以完全移除自定义的AppMiddleware和AppController中的静态文件处理逻辑，官方模块会自动处理所有静态文件请求和SPA路由。

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