Quarkus Amazon-Lambda-Rest本地Header正常，Native构建部署Lambda后失效

环境信息 #

• Java 17
• Quarkus BOM 3.5.1
• 部署目标：Amazon Lambda（Native构建）

问题描述 #

本地开发环境中Header传播功能正常，但将代码打包为Native构建部署到Lambda后，无法通过@HeaderParam获取请求头，仅能看到localhost和transfer-encoding两个Header字段。请求体解析正常，仅Header获取异常。

依赖配置（pom.xml） #

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-amazon-lambda-rest</artifactId>
</dependency>
<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-resteasy-jsonb</artifactId>
</dependency>

控制器代码 #

@Path("/path")
@RegisterForReflection(serialization = true)
@Slf4j
public class Controller {

    @Inject
    Service service;

    @POST
    @Path("/getHeader")
    public String getHeader(@HeaderParam("firstHeader") String headerField, RequestObject request) {
        log.info("firstHeader: {}", headerField); // headerField为null
        log.info("request name: {}", request.getName()); // 此部分正常工作
        return headerField;
    }
}

已尝试方案 #

• 使用拦截器检查Header，仅能看到localhost和transfer-encoding两个字段；
• 实现自定义ContainerRequestFilter检查Header传播情况，结果同上。

解决方案 #

1. 配置API Gateway映射模板传递Header #

通过API Gateway触发Lambda时，默认不会自动传递所有请求头，需在API Gateway集成请求中配置映射模板，将请求头映射到Lambda事件：

1. 进入API Gateway控制台，找到对应API和资源；
2. 在集成请求的「映射模板」中，添加application/json模板，内容如下：

{
  "body": $input.json('$'),
  "headers": {
    #foreach($header in $input.params().header.keySet())
    "$header": "$util.escapeJavaScript($input.params().header.get($header))"
    #if($foreach.hasNext),#end
    #end
  }
}

该模板会将所有请求头注入Lambda输入事件，Quarkus的lambda-rest扩展才能正确解析。

2. 确保Native构建的反射配置完整 #

虽然添加了@RegisterForReflection，但Header相关类可能在Native构建时被优化剔除，需在application.properties中添加：

quarkus.native.additional-build-args=-H:ReflectionConfigurationFiles=reflection-config.json

在src/main/resources下创建reflection-config.json，内容包含：

[
  {
    "name": "javax.ws.rs.core.HttpHeaders",
    "allDeclaredMethods": true
  },
  {
    "name": "org.jboss.resteasy.core.Headers",
    "allDeclaredMethods": true
  }
]

3. 直接从Lambda事件获取Header（临时 workaround） #

若上述配置仍有问题，可直接从APIGatewayProxyRequestEvent中提取Header：

@POST
@Path("/getHeader")
public String getHeader(APIGatewayProxyRequestEvent event, RequestObject request) {
    String headerField = event.getHeaders().get("firstHeader");
    log.info("firstHeader: {}", headerField);
    return headerField;
}

需确保添加依赖：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-amazon-lambda</artifactId>
</dependency>

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