部署在Tomcat的Spring Boot服务（含eureka-client-3.1.4）Eureka注册URL错误

当Spring Boot服务部署在外部Tomcat且带有独立上下文路径时，Eureka默认不会自动将上下文路径加入注册URL，以下是几种可靠的解决方法：

方法一：直接配置Eureka实例URL参数 #

通过配置文件显式指定包含上下文路径的实例ID和访问URL，简单直接：

properties格式 #

# 自定义实例ID，包含上下文路径便于在Eureka控制台识别
eureka.instance.instance-id=${spring.application.name}:${server.port}:${server.servlet.context-path}
# 注册的服务首页URL，完整包含端口和上下文路径
eureka.instance.home-page-url=http://${eureka.instance.hostname}:${server.port}${server.servlet.context-path}/
# 状态页URL（若使用Spring Boot Actuator）
eureka.instance.status-page-url=http://${eureka.instance.hostname}:${server.port}${server.servlet.context-path}/actuator/info

yaml格式 #

eureka:
  instance:
    instance-id: ${spring.application.name}:${server.port}:${server.servlet.context-path}
    home-page-url: http://${eureka.instance.hostname}:${server.port}${server.servlet.context-path}/
    status-page-url: http://${eureka.instance.hostname}:${server.port}${server.servlet.context-path}/actuator/info

方法二：自定义Eureka实例配置类 #

通过代码动态获取Tomcat的上下文路径，避免硬编码，适合上下文路径可能变化的场景：

import org.springframework.cloud.netflix.eureka.EurekaInstanceConfigBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.context.ServletContextAware;
import javax.servlet.ServletContext;

@Configuration
public class CustomEurekaInstanceConfig implements ServletContextAware {
    private String contextPath;

    @Override
    public void setServletContext(ServletContext servletContext) {
        // 从Tomcat上下文动态获取实际的上下文路径
        this.contextPath = servletContext.getContextPath();
    }

    @Bean
    public EurekaInstanceConfigBean eurekaInstanceConfigBean() {
        EurekaInstanceConfigBean config = new EurekaInstanceConfigBean();
        // 构建包含上下文路径的实例ID
        config.setInstanceId(String.format("%s:%s:%s",
                config.getAppname(), config.getNonSecurePort(), contextPath));
        // 设置完整的服务访问URL
        config.setHomePageUrl(String.format("http://%s:%s%s/",
                config.getHostname(), config.getNonSecurePort(), contextPath));
        // 设置Actuator状态页URL（按需配置）
        config.setStatusPageUrl(String.format("http://%s:%s%s/actuator/info",
                config.getHostname(), config.getNonSecurePort(), contextPath));
        return config;
    }
}

方法三：对齐Tomcat上下文路径与Spring Boot配置 #

如果Tomcat的上下文路径是通过war包名称或部署配置指定的（比如war包名为user-service.war，上下文路径为/user-service），可以在Spring Boot配置中同步设置server.servlet.context-path，让Eureka自动识别：

server.servlet.context-path=/user-service
eureka.instance.home-page-url=http://${eureka.instance.hostname}:${server.port}${server.servlet.context-path}/

关键注意事项 #

• 外部Tomcat部署时，server.port必须配置为Tomcat的实际运行端口，而非Spring Boot内置Tomcat的默认端口。
• 若使用Spring Boot Actuator，务必确保健康检查、状态页的URL都包含上下文路径，否则Eureka的服务健康检查会失效。

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