Go语言Lambda函数API响应错误映射失效，无法返回400状态码

我明白你的痛点——明明配置了响应映射到400，但API Gateway还是返回200，还想保持Lambda和映射验证逻辑分离对吧？这是因为当Go Lambda返回原生error类型时，API Gateway默认会把它当成函数执行成功的信号，只是把错误信息塞进errorMessage字段里，并不会自动触发HTTP错误状态码。

下面给你两个符合你需求的解决方案：

方案一：返回结构化错误（推荐，完美分离逻辑） #

Lambda只负责返回错误信息，API Gateway负责判断并映射状态码。修改你的Lambda代码，返回一个带错误信息的结构体，而不是原生error：

package main

import (
	"github.com/aws/aws-lambda-go/lambda"
)

// 定义结构化的错误响应结构体
type ErrorResponse struct {
	ErrorMessage string `json:"errorMessage"`
}

func main() {
	lambda.Start(returnError)
}

func returnError() (interface{}, error) {
	// 返回nil作为error参数，同时传递错误数据
	return ErrorResponse{ErrorMessage: "Something went wrong!"}, nil
}

然后去API Gateway配置集成响应：

• 先在方法响应里添加400状态码
• 切换到集成响应，给400状态码设置映射模板（Content-Type选application/json），模板内容：

#set($inputRoot = $input.path('$'))
{
  "error": "$inputRoot.errorMessage"
}

• 关键一步：在400状态码的错误条件里，输入判断表达式$input.path('$.errorMessage') != ""，这样当Lambda返回带errorMessage的结构体时，API Gateway就会自动返回400状态码。

方案二：用模板强制覆盖状态码（无需修改Lambda返回结构） #

如果你不想改Lambda的返回逻辑，也可以通过API Gateway的映射模板来捕获Lambda返回的errorMessage，并强制把状态码改成400：

• 确保方法响应里已经添加了400状态码
• 在集成响应的200状态码下添加映射模板，内容如下：

#set($inputRoot = $input.path('$'))
#if($inputRoot.errorMessage)
  #set($context.responseOverride.status = 400)
#end
{
  "error": "$inputRoot.errorMessage"
}

这个模板的逻辑是：如果收到的响应里有errorMessage字段，就通过$context.responseOverride.status把状态码强制改成400，同时返回错误信息。

额外提醒：区分代理集成和普通集成 #

如果你的API Gateway用的是Lambda代理集成，那上面的方案可能不适用——代理集成要求Lambda返回完整的HTTP响应结构体，包括statusCode。但这种方式会把HTTP状态码逻辑耦合到Lambda里，不符合你分离逻辑的需求，所以更推荐前两种普通集成的方案。

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