Next.js部署AWS Amplify重写时User Agent Header异常问题求助

问题根源 #

AWS Amplify默认的重写规则会用CloudFront的User Agent转发请求到外部服务器，没有保留用户的原始请求头，导致外部服务器只能拿到Amazon CloudFront这个代理标识。

解决步骤 #

1. 修改Amplify重写规则，转发原始User Agent #

你可以通过两种方式配置：

• 控制台配置：进入Amplify控制台，找到你的应用，点击Rewrites and redirects，编辑现有重写规则，添加headers配置：

  {
    "source": "/api/*",
    "target": "https://你的外部服务器地址/api/$1",
    "status": "200",
    "headers": {
      "User-Agent": "$http_user_agent"
    }
  }
  

• 代码配置：在项目根目录的amplify.yml中，添加重写规则的headers配置：

  hosting:
    rewriteRules:
      - source: /api/*
        target: https://你的外部服务器地址/api/$1
        status: 200
        headers:
          User-Agent: "$http_user_agent"
  

  这里的$http_user_agent是Amplify支持的Nginx变量，会直接引用用户请求的原始User Agent头。

2. 备用方案：通过自定义头传递原始User Agent #

如果直接替换User-Agent头不生效，可以把原始代理放到自定义头中，让外部服务器读取这个头：
修改重写规则的headers部分：

"headers": {
  "X-Original-User-Agent": "$http_user_agent"
}

之后在外部服务器的业务代码中，优先读取X-Original-User-Agent作为真实用户代理。

3. 检查CloudFront的源请求策略 #

如果上面的配置还是没效果，需要检查Amplify关联的CloudFront分发：

1. 进入CloudFront控制台，找到Amplify应用对应的分发；
2. 点击行为标签，编辑目标行为；
3. 在源请求策略中，选择包含User-Agent头的策略（比如Managed-AllViewerExceptHostHeader），或者创建自定义策略，确保User-Agent被转发到源服务器。

验证方式 #

修改配置后重新部署应用，用curl或者Postman发送带自定义User Agent的请求：

curl -H "User-Agent: MyTestBrowser/1.0" https://你的Amplify域名/api/test

然后查看外部服务器的日志，确认是否收到了MyTestBrowser/1.0这个真实的用户代理。

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