Spring Boot如何将同一Controller的不同接口映射到不同主机域名

结论：你提到的直接在路由注解中写完整域名的写法不可行 #

Spring MVC 体系中，@PostMapping、@GetMapping等派生自@RequestMapping的路由注解，其路径参数默认仅匹配请求的URI路径部分，不会对请求的主机域名做校验。如果你直接填入完整域名，Spring会把整个字符串当做URI路径处理，只有请求地址为http://<你的服务部署地址>:<端口>/http://management.com/api/post/books时才能匹配到对应的接口，完全不符合需求。

可行的实现方案 #

方案1：使用高版本Spring原生host属性（Spring Boot 3.2+ / Spring Framework 6.1+ 优先选择） #

该版本范围的Spring已经原生支持在路由注解中通过host参数指定匹配的域名，代码侵入性极低，写法如下：

@RestController
public class BookController{
  private BookService bookService;

  @PostMapping(path = "/api/post/books", host = "management.com")
  public Book addBookUsingManagementConsole(@RequestBody BookAdd newBook) {
    // 业务逻辑实现
  }

  @GetMapping(path = "/api/get/books", host = "publicpage.com")
  public Book searchBooksUsingPublicPage(@RequestParam(name="name") String name) {
    // 业务逻辑实现
  }
}

如果需要匹配带端口的域名，直接在host值中添加端口即可，例如host = "management.com:8080"。

方案2：前置网关做域名路由（生产环境推荐） #

不需要修改服务内部的路由规则，在服务前面部署Nginx、Spring Cloud Gateway等网关组件，配置域名转发规则即可：

1. 将management.com域名下的所有请求，转发到后端服务的管理类接口路径组
2. 将publicpage.com域名下的所有请求，转发到后端服务的公开类接口路径组

建议同时对两类接口做路径前缀区分，比如管理接口统一加/admin前缀，公开接口统一加/public前缀，后续可以更方便的在网关层配置鉴权、限流、跨域等通用能力，扩展性更强。

方案3：自定义请求匹配规则（适配低版本Spring） #

如果你使用的Spring版本不支持host属性，可以通过以下两种方式实现：

• 实现RequestCondition接口自定义基于Host请求头的匹配逻辑，注册到Spring MVC的路由匹配体系中
• 编写全局过滤器/拦截器，读取请求的Host头和预设的域名规则做比对，不符合匹配规则的请求直接返回404状态码即可

内容的提问来源于stack exchange，提问作者Zhe Sheng Lim