NestJS部署GCP Cloud Function时自定义500错误消息不生效

当NestJS部署在GCP Cloud Function时，直接抛出HttpException返回自定义500错误消息会被屏蔽，客户端仅收到默认的"Internal Server error"，这是GCP对5xx错误的默认安全处理导致的，以下是几种可行的解决方法：

1. 调整HttpException的响应格式 #

GCP会优先保留JSON格式的错误响应，而非纯字符串。将自定义消息包裹在对象中抛出：

throw new HttpException(
  { message: errorResponse }, 
  HttpStatus.INTERNAL_SERVER_ERROR
);

同时要确保errorResponse是字符串类型，避免直接传递Error对象——可以在catch块中提取错误消息：

catch (err) {
  this.logger.warn(err);
  errorResponse = err.message || error_messages.PROCESS_FAIL;
}

2. 全局异常过滤器强制控制响应 #

通过NestJS的异常过滤器统一处理所有HttpException，确保响应格式被正确保留：

创建src/filters/http-exception.filter.ts：

import { ExceptionFilter, Catch, ArgumentsHost, HttpException } from '@nestjs/common';
import { Response } from 'express';

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse<Response>();
    const status = exception.getStatus();
    const exceptionResponse = exception.getResponse();

    // 提取错误消息，兼容字符串和对象格式的响应
    const errorMessage = typeof exceptionResponse === 'string'
      ? exceptionResponse
      : (exceptionResponse as { message: string }).message;

    response
      .status(status)
      .json({
        statusCode: status,
        message: errorMessage,
      });
  }
}

在main.ts中注册全局过滤器：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { HttpExceptionFilter } from './filters/http-exception.filter';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalFilters(new HttpExceptionFilter());
  await app.listen(process.env.PORT || 3000);
}
bootstrap();

3. 验证GCP函数响应设置 #

确保Cloud Function的运行时没有修改响应内容。GCP会保留有效JSON格式的5xx响应体，只要你的返回是符合标准的JSON结构，就不会被替换成默认提示。

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