如何在Quarkus Lambda函数中为AWS Lambda响应添加CORS头？

问题原因 #

你在application.properties里配置的quarkus.http.cors系列参数无效，是因为Lambda代理集成模式下，Quarkus并非以常规HTTP服务器运行，这些针对HTTP服务器的CORS配置不会被应用到Lambda的响应中。此时API Gateway会直接转发Lambda返回的响应内容，必须在Lambda的响应payload中明确包含CORS头才能解决跨域问题。

解决方案 #

方案1：单个端点手动添加CORS头 #

修改你的资源方法，使用Response对象构建响应，直接在响应中添加所需的CORS头：

@Path("/hello")
public class GreetingResource {

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public Response hello() {
        String json = """
            {
                "msg": "hello"
            }
            """;
        return Response.ok(json)
                .header("Access-Control-Allow-Origin", "*")
                .header("Access-Control-Allow-Methods", "GET,PUT,POST")
                .header("Access-Control-Allow-Headers", "x-api-key, accept, authorization, content-type")
                .header("Access-Control-Allow-Credentials", "true")
                .build();
    }
}

方案2：全局过滤器统一处理CORS #

如果有多个端点，不想重复写头信息，可以创建一个JAX-RS过滤器，自动给所有响应添加CORS头：

@Provider
public class CorsFilter implements ContainerResponseFilter {
    @Override
    public void filter(ContainerRequestContext requestContext, ContainerResponseContext responseContext) throws IOException {
        responseContext.getHeaders().add("Access-Control-Allow-Origin", "*");
        responseContext.getHeaders().add("Access-Control-Allow-Methods", "GET,PUT,POST");
        responseContext.getHeaders().add("Access-Control-Allow-Headers", "x-api-key, accept, authorization, content-type");
        responseContext.getHeaders().add("Access-Control-Allow-Credentials", "true");
    }
}

这个过滤器会自动对所有JAX-RS接口的响应生效，无需逐个修改资源方法。

额外检查项 #

• 确认API Gateway的CORS配置：Lambda代理模式下，API Gateway的CORS设置会被Lambda返回的头覆盖，所以确保两者配置一致，或者直接依赖Lambda返回的头即可。
• 处理OPTIONS预检请求：浏览器发起跨域请求前会先发OPTIONS预检请求，使用上述过滤器会自动处理；如果手动处理，需要为每个端点添加OPTIONS方法的实现，或者确保API Gateway的OPTIONS集成响应配置正确（推荐让Lambda处理OPTIONS）。

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