Spring Hatoeas ControllerLinkBuilder生成ELB URL而非CloudFront公网URL问题

这个问题我之前在类似的AWS架构里碰到过！核心原因确实是你的Spring应用部署在ELB后端，CloudFront转发请求到ELB时，应用接收到的请求头里的Host是ELB的域名，而Spring HATEOAS的ControllerLinkBuilder默认会从当前请求的Host、协议等信息生成链接，所以才会返回ELB的地址而非预期的CloudFront公网URL。下面给你几个实用的解决办法：

方案一：配置转发头，让Spring识别真实外部地址 #

这是最符合HTTP规范、也最灵活的方案，需要在CloudFront和Spring两端做配置：

1. CloudFront端配置：确保CloudFront转发请求时，传递X-Forwarded-Host（设置为你的CloudFront公网域名）、X-Forwarded-Proto（设置为https，因为用户访问的是CloudFront的HTTPS地址）以及X-Forwarded-Port（设置为443）这几个头。
2. Spring端配置：开启Spring对转发头的处理，让它优先使用这些头里的信息生成链接。
   • 如果是Spring Boot应用，直接在application.properties或application.yml里添加：

     server.forward-headers-strategy=NATIVE
     

   • 如果是传统Spring MVC应用，注册ForwardedHeaderFilter过滤器：

     @Bean
     public FilterRegistrationBean<ForwardedHeaderFilter> forwardedHeaderFilter() {
         FilterRegistrationBean<ForwardedHeaderFilter> registration = new FilterRegistrationBean<>();
         registration.setFilter(new ForwardedHeaderFilter());
         // 设置最高优先级，确保请求先经过这个过滤器处理
         registration.setOrder(Ordered.HIGHEST_PRECEDENCE);
         return registration;
     }
     

配置完成后，Spring HATEOAS就会自动用CloudFront的域名和HTTPS协议生成链接了。

方案二：自定义LinkBuilder强制使用CloudFront地址 #

如果你的环境无法配置转发头（比如权限限制），可以自定义一个LinkBuilder来硬编码或从配置读取CloudFront地址：

1. 先在配置文件里添加CloudFront的公网URL：

   cloudfront.public.url=https://{public_cloudfront_url}
   

2. 自定义LinkBuilder类：

   @Component
   public class CloudFrontLinkBuilder extends ControllerLinkBuilder {
   
       @Value("${cloudfront.public.url}")
       private String cloudFrontPublicUrl;
   
       public static CloudFrontLinkBuilder linkTo(Class<?> controller, Object... parameters) {
           CloudFrontLinkBuilder builder = new CloudFrontLinkBuilder();
           builder.setController(controller);
           builder.setParameters(parameters);
           return builder;
       }
   
       @Override
       protected UriComponentsBuilder getUriComponentsBuilder() {
           // 获取默认生成的路径，替换为CloudFront的域名和协议
           UriComponentsBuilder originalBuilder = super.getUriComponentsBuilder();
           String path = originalBuilder.build().getPath();
           return UriComponentsBuilder.fromUriString(cloudFrontPublicUrl).path(path);
       }
   }
   

3. 在控制器里使用这个自定义的LinkBuilder代替默认的ControllerLinkBuilder：

   @GetMapping("/api/something")
   public ResponseEntity<Resource<Something>> getSomething() {
       Something something = new Something("something");
       Link link = CloudFrontLinkBuilder.linkTo(SomethingController.class).withRel("something");
       Resource<Something> resource = new Resource<>(something, link);
       return ResponseEntity.ok(resource);
   }
   

方案三：直接配置Spring的外部访问地址 #

如果你的CloudFront地址是固定不变的，也可以直接在Spring配置里指定外部公网地址：

server.servlet.context-path=/api
server.public-url=https://{public_cloudfront_url}
server.public-protocol=https
server.public-port=443

这个方式比较简单，但灵活性稍差，适合地址固定的场景。

个人最推荐方案一，它能自动适配不同环境（比如测试、生产的CloudFront地址不同），而且符合HTTP转发的标准流程。

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