如何配置Azure Function App以保留Nest.js应用设置的响应头？

我之前在把Nest.js应用部署到Azure Function App本地运行时的时候，也踩过类似的响应头丢失的坑，给你几个实用的排查和解决方向：

1. 确保Nest.js的响应头正确映射到Azure Function上下文 #

Azure Functions的HTTP触发器有自己的响应处理机制，默认情况下，Nest.js设置的响应头可能不会自动同步到context.res对象里。如果用的是@nestjs/azure-func-http适配器，你需要手动把Nest返回的响应头复制到Azure的响应上下文：

import { Context, HttpRequest } from '@azure/functions';
import { NestFactory } from '@nestjs/core';
import { AppModule } from './src/app.module';
import { AzureHttpAdapter } from '@nestjs/azure-func-http';

export async function(context: Context, req: HttpRequest) {
  const adapter = new AzureHttpAdapter();
  const app = await NestFactory.create(AppModule, adapter);
  await app.init();

  const nestResponse = await adapter.handle(req, context);
  
  // 手动同步所有Nest设置的响应头
  if (nestResponse.headers) {
    Object.assign(context.res.headers, nestResponse.headers);
  }

  return nestResponse;
}

2. 检查host.json的HTTP配置 #

Azure Functions的host.json文件里有HTTP相关的配置，可能会影响响应头的传递。你可以添加或调整以下配置，确保自定义头不会被过滤：

{
  "version": "2.0",
  "extensions": {
    "http": {
      "customHeaders": {
        // 这里无需硬编码动态头，只要确保没有配置restrictedHeaders这类过滤规则即可
      },
      "routePrefix": ""
    }
  }
}

3. 验证CORS配置是否暴露了自定义头 #

如果客户端看不到响应头，很可能是CORS配置没有把这些头加入到暴露列表里。在local.settings.json里添加ExposedHeaders配置：

{
  "IsEncrypted": false,
  "Values": {
    // 你的其他环境变量
  },
  "Host": {
    "CORS": "*",
    "ExposedHeaders": "X-Your-Custom-Header,Another-Custom-Header"
  }
}

把你设置的自定义头逐个加到ExposedHeaders里，这样客户端就能正常接收到这些头了。

4. 确认Nest.js的中间件/拦截器正常执行 #

有时候在Azure Function环境下，Nest.js的某些中间件或拦截器可能没有被正确触发。你可以在设置响应头的拦截器里添加日志，确认头确实被设置到了响应对象上：

@Injectable()
export class CustomHeaderInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    return next.handle().pipe(
      tap((response) => {
        const res = context.switchToHttp().getResponse();
        res.setHeader('X-Custom-Header', 'test-value');
        console.log('已设置的响应头:', res.getHeaders()); // 打印日志确认
      }),
    );
  }
}

如果日志里显示头已经被设置，但Azure响应里没有，那问题就出在头的映射环节，回到第一步调整即可。

5. 测试直接在Azure Function里设置头 #

你可以先跳过Nest.js，直接在Azure Function入口里设置响应头，测试是否能正常返回：

export async function(context: Context, req: HttpRequest) {
  context.res = {
    status: 200,
    body: 'Test',
    headers: {
      'X-Test-Header': 'test-value'
    }
  };
}

如果这个测试能在响应里看到头，说明Azure Function本身支持自定义头，问题肯定出在Nest.js和Azure的适配层，按照前面的方法调整映射即可。

内容的提问来源于stack exchange，提问作者Guy Stephane Manganneau