Spring Cloud Eureka 服务注册中心和配置中心搭建指南

原创 已于 2025-04-26 20:14:17 修改 · 1.8k 阅读 · 24 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
于 2025-04-26 14:38:38 首次发布

本指南详细介绍如何搭建一个单节点的 Eureka 服务注册中心，并让 Spring Cloud 微服务注册到 Eureka。同时讲解如何搭建 Spring Cloud Config 配置中心（使用 Gitee 代码仓库存放配置），以及客户端微服务如何从配置中心读取远程配置、实现配置更新的自动刷新（利用 Spring Cloud Bus 消息总线）。文中使用 Spring Boot 2.7.x 搭配 Spring Cloud 2021.x 版本作为示例环境​spring.io​spring.io。示例中每一步都提供关键的 POM 依赖配置和 application.yml 配置片段，并给出注意事项和常见错误的排查方法。

一、搭建单节点 Eureka Server

Eureka Server 是 Netflix 提供的服务注册与发现组件。我们首先搭建一个单节点（非高可用集群）的 Eureka 服务注册中心，用于注册和管理微服务实例。单节点部署时，需要避免 Eureka Server 将自己作为客户端再次注册到自身​cnblogs.com。

搭建步骤：

  1. 创建工程并引入依赖： 创建一个新的 Spring Boot 项目（建议使用 Spring Boot 2.7.x）。在项目的 Maven POM 文件中引入 Eureka Server 的起步依赖和 Spring Cloud BOM。例如：

    <dependencyManagement>
    <dependencies>
        <!-- 引入 Spring Cloud 2021.x 依赖版本管理 BOM -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2021.0.5</version> <!-- 示例版本，可按需调整 -->
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependencies>
    <!-- Eureka Server 服务端依赖 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-server</artifactId>
    </dependency>
    <!-- （可选）Actuator 依赖，用于健康监控等 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

    上述依赖引入了 Eureka Server 模块。在 Spring Boot 主类上添加 @EnableEurekaServer 注解，开启 Eureka 服务注册中心功能​javafullstackdev.medium.com​javafullstackdev.medium.com。

  2. 配置 Eureka Server 应用参数： 在 src/main/resources 下创建应用配置文件，建议使用 application.yml。配置如下：

    yaml

server:
  port: 8761               # Eureka Server 启动端口（常用8761）
spring:
  application:
    name: eureka-server    # 应用名称（可选）
eureka:
  instance:
    hostname: localhost    # 本机hostname，可换成IP或域名
  client:
    register-with-eureka: false  # 单节点时，禁止向自己注册&#8203;:contentReference[oaicite:5]{index=5}
    fetch-registry: false        # 单节点时，不从别的 Eureka 拉取注册表&#8203;:contentReference[oaicite:6]{index=6}

    配置解释：将 register-with-eureka 和 fetch-registry 都设置为 false，表示这个 Eureka Server 不作为客户端注册自身，也不去拉取其他 Eureka 节点的服务列表​cnblogs.com。hostname 可设置为服务注册中心对外公告的地址。在单机环境下，上述配置足以启动一个 Eureka 注册中心。

  3. 启动并验证： 运行 Eureka Server 应用。在控制台日志看到 Started EurekaServerApplication 字样且无错误后，访问 http://localhost:8761/ 可以查看 Eureka Server 的管理界面。初次打开时，由于尚未有微服务注册，界面上应显示没有可用的服务实例。至此，单节点 Eureka Server 注册中心已经成功搭建。

注意： 单节点部署主要用于开发和测试，不需要配置高可用。生产环境若需高可用，可部署多个 Eureka Server 实例组成集群，但那不在本文讨论范围。确保 Eureka Server 所在主机的防火墙放行了8761端口，客户端才能正常注册。

二、配置微服务注册到 Eureka

有了注册中心后，我们需要将各个 Spring Cloud 微服务注册到 Eureka 上。下面以一个示例微服务说明如何进行配置，使其在启动时自动向 Eureka 服务注册中心注册自身。

主要步骤：

  1. 添加 Eureka Client 依赖： 在微服务的 Maven POM 中引入 Eureka Client 的起步依赖。通常使用 spring-cloud-starter-netflix-eureka-client 来包含 Eureka 客户端功能​piterjia.github.io。例如：

    <dependencies>
    <!-- Eureka Client 客户端依赖 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
    <!-- 一般微服务还需要 Web 和 Actuator 依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

    确保该微服务也使用与 Eureka Server 相同的 Spring Cloud BOM 管理依赖版本，以避免版本不兼容问题。

  2. 启用 Eureka 客户端注解（可选）： 在微服务的主启动类上，可以添加 @EnableDiscoveryClient 或 @EnableEurekaClient 注解来显式启用服务发现客户端。​piterjia.github.io不过，当引入了 Eureka Client 依赖后，Spring Boot 会自动配置服务注册，添加注解只是出于明确语义，非必需。

  3. 配置应用名称和 Eureka 注册中心地址： 在微服务的 application.yml 中，配置基本参数：应用名、服务端口，以及 Eureka 客户端指向 Eureka Server 的地址。例如：

    yaml

server:
  port: 8081                         # 微服务启动端口，不与其他服务冲突
spring:
  application:
    name: order-service              # 微服务名称，将作为 Eureka 中的服务ID
eureka:
  instance:
    prefer-ip-address: true          # 可选：注册时优先使用IP地址而非主机名
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka  # Eureka Server 的地址&#8203;:contentReference[oaicite:10]{index=10}
    # 如果有多个配置，可用逗号分隔多个URL

    配置解释：spring.application.name 设置微服务在 Eureka 中注册的名称；defaultZone 指定 Eureka 服务注册中心的访问地址（假定 Eureka Server 部署在本机8761端口）​blog.csdn.net。prefer-ip-address: true 会让服务注册时使用IP，有助于避免由于主机名解析导致的连接问题。

  4. 启动并验证注册： 先确保 Eureka Server 已经启动。然后启动该微服务应用。在启动日志中应能看到与 Eureka 交互的日志信息，例如定时发送心跳等。打开 Eureka Server 管理界面刷新页面，应看到 order-service 已出现在“Instances currently registered with Eureka”列表中，状态为 UP。这说明微服务成功注册到了 Eureka。

注意： 微服务启动后每隔30秒会向 Eureka 发送心跳，Eureka 默认90秒收不到心跳则将实例剔除​cnblogs.com​cnblogs.com。因此确保微服务和 Eureka Server 的时间同步和网络连通。如果微服务没有出现在注册列表：

  • 请检查 Eureka Server 地址是否配置正确，网络是否可达。

  • 确认微服务的应用名不为空，且依赖和注解配置正确。

  • 查看微服务日志中是否有 Eureka 相关错误提示，例如认证错误或连接超时。

三、搭建 Spring Cloud Config Server（使用 Gitee 远程仓库）

Spring Cloud Config Server 用于集中管理分布式系统的配置。我们将搭建一个 Config Server，并使用 Gitee 上的 Git 仓库存放配置。Config Server 会从远程仓库拉取配置文件，供客户端微服务按需获取。

配置中心服务端搭建步骤：

  1. 创建 Config Server 工程并添加依赖： 新建一个 Spring Boot 应用（可与 Eureka Server 分开部署，也可以作为独立微服务）。在 POM 中引入 Config Server 起步依赖：

    <dependencies>
    <!-- Spring Cloud Config Server 依赖 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-config-server</artifactId>
    </dependency>
    <!-- （可选）Eureka Client 依赖，将配置中心注册到 Eureka 以供发现 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
    <!-- （可选）Bus 消息总线依赖，后续用于配置刷新 -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-bus-amqp</artifactId>
    </dependency>
</dependencies>

    引入上述依赖后，在配置中心的启动类上添加 @EnableConfigServer 注解，启用配置中心服务端功能​cnblogs.com​cnblogs.com。如果希望 Config Server 本身也注册到 Eureka，还需确保加了 Eureka Client 依赖和相关配置。

  2. 准备远程 Git 仓库（Gitee）： 在 Gitee 上创建一个用于存放配置的代码仓库（例如 config-repo）。仓库可以选择公开（公开仓库读取无需凭证）或私有。如果是私有仓库，需要配置访问凭证。为了简单，建议初次尝试使用公开仓库。
    在该仓库中，根据 Spring Cloud Config 的命名规则添加配置文件。例如，可以创建文件：

    • application-dev.yml：全局默认配置（应用名为 "application" 表示通用配置），用于开发环境。

    • 或为每个微服务创建独立配置，如 order-service-dev.yml 对应 order-service 微服务在 dev 环境的配置。
      命名约定： 默认格式为 {application}-{profile}.yml（或 .properties），其中 application 对应微服务的 spring.application.name，profile 是环境名称​blog.csdn.net。也可以使用仓库的分支来区分环境（对应 Config Server 请求中的 label 参数）。

  3. 配置 Config Server 连接 Gitee 仓库： 在 Config Server 的 application.yml 中，设置 Git 仓库的地址及必要的属性，例如：

    yaml

server:
  port: 8888                         # Config Server 默认端口一般设为8888
spring:
  application:
    name: config-server              # 配置中心服务名（注册到 Eureka 可用）
  cloud:
    config:
      server:
        git:
          uri: https://gitee.com/<你的用户名>/<仓库名>.git   # 远程Git仓库URL
          clone-on-start: true       # （可选）启动时立即克隆仓库&#8203;:contentReference[oaicite:17]{index=17}&#8203;:contentReference[oaicite:18]{index=18}
          search-paths: config       # （可选）搜索路径，如果配置文件不在仓库根目录
          username: <用户名>         # 私有仓库时的用户名&#8203;:contentReference[oaicite:19]{index=19}
          password: <密码或访问令牌>  # 私有仓库访问密码或Gitee个人访问Token&#8203;:contentReference[oaicite:20]{index=20}
        # 如果使用分支存储配置，可加 label 属性指定默认分支，如:
        # label: master
eureka:
  client:
    service-url:
      defaultZone: http://localhost:8761/eureka    # （可选）将配置中心注册到 Eureka&#8203;:contentReference[oaicite:21]{index=21}

    配置讲解：

    • spring.cloud.config.server.git.uri 指定 Gitee 仓库的 Git 地址。如果仓库是公开的，用 HTTPS URL 即可直接访问；如果是私有仓库，需要同时提供 username 和 password（推荐使用个人访问令牌作为密码，以提高安全性）​cnblogs.com。也可以使用 SSH 地址（例如 git@gitee.com:用户名/仓库.git），此时需配置 SSH 私钥（spring.cloud.config.server.git.privateKey）​cnblogs.com或确保主机已配置相应 SSH 公钥信任​blog.csdn.net​blog.csdn.net。

    • clone-on-start: true 表示 Config Server 启动时立即从远程获取配置​github.com​github.com，避免首次请求时延迟。

    • search-paths 若仓库中把配置文件放在子目录下，需要指定。例如上例设为 config 则会在仓库的 config/ 目录下寻找配置​blog.csdn.net。如果配置文件在仓库根目录，可不配置此项。

    • eureka.client.service-url.defaultZone 若填写，则 Config Server 将自身作为客户端注册到 Eureka 服务中心，方便其它微服务通过服务发现找到配置中心（需配合客户端的 discovery 配置，后文介绍）。若不需要可省略。

  4. 启动 Config Server 并验证： 启动配置中心应用，观察日志确认成功克隆了远程仓库配置（日志会显示 Git 克隆信息）。访问 Config Server 提供的配置读取接口，例如：

    http://localhost:8888/order-service/dev

    这将返回仓库中 order-service-dev.yml 文件的内容（以JSON格式输出）。如果返回了正确的配置数据，则说明 Config Server 正常工作。若返回错误或找不到文件，请检查仓库URL、凭证以及文件命名是否正确匹配请求的应用名和profile。

注意： 使用 Gitee 私有仓库时：

  • 公开仓库无需配置凭证，但私有仓库必须提供认证信息。可采用 HTTP Basic（username/password）方式​cnblogs.com，或 SSH 方式​cnblogs.com。若使用个人访问令牌（Access Token），在 Gitee 用户设置中生成 Token，然后将其当作密码使用（username填写Gitee用户名）。

  • Gitee 克隆可能需要信任主机密钥。使用 SSH URL 时，可能出现 “reject HostKey: gitee.com” 错误​blog.csdn.net。解决方法是预先在服务器上配置好 SSH 公私钥并将公钥添加到 Gitee 信任，或者在 Config Server 配置中添加 spring.cloud.config.server.git.ignoreLocalSshSettings=true 和相应的私钥配置​cnblogs.com。简单起见，推荐初次尝试使用 HTTPS 加用户名/密码方式。

  • Config Server 默认会缓存从Git拉取的配置，如需强制拉取最新，可以调用刷新端点（后续介绍）或者将 spring.cloud.config.server.git.refreshRate 调小。一般无需修改，除非配置更新频繁且不使用通知机制。

四、配置客户端微服务读取远程配置

搭建好 Config Server 后，微服务（Config Client）需要从配置中心获取其配置，而不是使用本地的 application.yml 中硬编码配置。Spring Cloud 提供了 Config Client 来在应用启动时获取远程配置。

客户端配置步骤：

  1. 引入 Config Client 依赖： 在需要从配置中心获取配置的微服务的 POM 中，加入 Spring Cloud Config 客户端起步依赖：

    <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-config</artifactId>
</dependency>

    这样应用在启动时即可启用从 Config Server 拉取配置的能力。

  2. 配置 Config Server 地址： 微服务需要知道配置中心的位置。推荐在启动阶段就获取配置，因此可以使用 bootstrap.yml（在 Spring Boot 2.4+ 也可以使用 application.yml 的 spring.config.import）。为简单起见，这里使用 bootstrap.yml：

    yaml

spring:
  application:
    name: order-service               # 应用名称，要和配置仓库中的文件名匹配
  cloud:
    config:
      uri: http://localhost:8888      # 配置中心的访问地址（Config Server的URL）
      profile: dev                    # 要加载的配置profile（如开发环境dev）&#8203;:contentReference[oaicite:33]{index=33}&#8203;:contentReference[oaicite:34]{index=34}
      label: master                   # 可选：配置仓库的分支名，默认为master
      # 如果希望通过服务发现找Config Server，可用以下配置替代uri:
      # discovery:
      #   enabled: true
      #   service-id: config-server   # Config Server在Eureka注册的服务名&#8203;:contentReference[oaicite:35]{index=35}&#8203;:contentReference[oaicite:36]{index=36}

    配置解释：

    • spring.application.name 应用名称必须与配置仓库中相应配置文件的名字部分一致。例如这里是 order-service，则仓库应有 order-service-dev.yml。

    • spring.cloud.config.uri 直接指定了 Config Server 的地址和端口。如果 Config Server 也注册到了 Eureka，并且想让客户端通过服务发现动态定位，可以使用 discovery.enabled=true 和指定 service-id（如上注释所示），这样 Config Client 会先从 Eureka 查找名为 config-server 的服务地址​github.com​github.com。需注意此模式下，客户端自身也需要先注册到 Eureka，且可能需要在本地有最基本的 Eureka 配置。一般小型项目直接配置 uri 更简单。

    • spring.cloud.config.profile 指定要加载哪个环境的配置文件，比如 dev、prod 等​github.com。当有多个profile时可用逗号分隔或使用 Spring 的多环境激活机制。

    • spring.cloud.config.label 指定Git仓库的分支，默认为 master 主分支。如果使用了其他分支存储配置（如 dev 分支保存开发环境配置），需要设置此项匹配。

  3. 启动顺序与验证： 确保配置中心 Config Server 先启动且运行正常。然后启动客户端微服务。在客户端启动日志中，应能看到从配置中心拉取配置的日志，例如“Fetching config from server at: http://localhost:8888”之类的字样。如果获取成功，应用将把远程配置应用到环境中。可以通过输出配置信息或访问Actuator的 /actuator/configprops 来验证配置是否生效。

    若客户端启动时报错无法连接配置中心，可能原因：Config Server 未启动、spring.cloud.config.uri 配置不正确，或网络不通。如果只是配置未生效或部分属性缺失，检查应用名和profile是否匹配仓库中的文件名。注意：默认情况下，如果无法从配置中心获取配置，应用仍会启动（非fail-fast），但会使用本地默认配置或报错。可通过设置 spring.cloud.config.fail-fast=true 来让获取失败时终止启动，以防止应用在错误配置下运行。

  4. 使用远程配置： 客户端微服务获取的远程配置会注入到Environment中。业务代码中可以像平时一样使用 @Value 或 @ConfigurationProperties 注解来注入配置值。如果希望在运行过程中刷新配置，需要对相应的Bean使用 @RefreshScope 注解。比如：

    @RefreshScope
@RestController
public class TestController {
    @Value("${my.custom.prop}")
    private String myProp;
    // ...
}

注意： 配置文件的组织方式可以灵活调整。例如可在仓库中建立按应用名的子文件夹分类配置，需配合 Config Server 的 search-paths 设置​blog.csdn.net。另外，如果多个微服务共享一些通用配置，可以利用 application.yml（应用名为 "application"）作为所有服务的默认配置文件，被各客户端自动加载。客户端请求配置时，Config Server 会按顺序返回 {application}.yml 和 {application}-{profile}.yml 合并后的结果​blog.csdn.net。

五、实现配置的自动刷新（Spring Cloud Bus）

当我们更新了配置仓库中的配置文件时，希望客户端微服务能够无需重启地刷新加载新的配置。Spring Cloud Bus 利用消息代理（如 RabbitMQ 或 Kafka）广播配置变更事件，实现分布式系统中配置的动态刷新​mrbird.cc。下面介绍如何集成 Spring Cloud Bus 来自动拉取配置更新。

步骤与要点：

  1. 准备消息代理： Spring Cloud Bus 目前支持 RabbitMQ 和 Kafka 两种消息中间件。这里以 RabbitMQ 为例（因为配置相对简单）。请确保环境中已部署 RabbitMQ 服务，并记录其地址、用户名和密码。默认情况下，RabbitMQ 本地安装后用户名密码为 guest/guest，管理端口为 15672，AMQP 端口为 5672​github.com​github.com。

  2. 引入 Bus 依赖： 在 配置中心 和 所有需要自动刷新的客户端微服务 的 POM 中都添加 Spring Cloud Bus RabbitMQ 的起步依赖（若之前步骤中已添加则无需重复）：

    <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bus-amqp</artifactId>
</dependency>

    同时确保有 Spring Boot Actuator 依赖，以便暴露刷新端点（前述步骤已经添加过）。引入依赖后，应用会自动加入 Spring Cloud Bus 总线，并通过消息中间件与其他节点通信​mrbird.cc。

  3. 配置 RabbitMQ 连接和 Actuator 端点： 在配置中心和客户端的 application.yml 中，添加 RabbitMQ 的连接信息，以及开启 Bus 刷新端点暴露：

    yaml

spring:
  rabbitmq:
    host: localhost       # RabbitMQ 主机
    port: 5672            # RabbitMQ 端口
    username: guest       # 用户名
    password: guest       # 密码
management:
  endpoints:
    web:
      exposure:
        include: "bus-refresh,refresh"   # 暴露bus-refresh端点（配置中心用），refresh端点（客户端用）&#8203;:contentReference[oaicite:46]{index=46}&#8203;:contentReference[oaicite:47]{index=47}

    配置说明：

    • spring.rabbitmq.* 部分告知应用如何连接 RabbitMQ。请根据实际安装地址修改，如果 RabbitMQ 不在本机或使用了自定义账户，请调整 host 和认证信息。

    • management.endpoints.web.exposure.include 用于开放 Spring Boot Actuator 的HTTP端点。这里在配置中心开启了 bus-refresh，在客户端开启了 refresh（也可以统一都开启 "bus-refresh,refresh"）。这样，我们可以调用 /actuator/bus-refresh 来广播刷新，也可以单独调用某个实例的 /actuator/refresh。​github.com​github.com

    • 确保 Actuator 总线刷新端点受保护（默认情况需要通过POST请求并有合适的权限策略，生产中可考虑安全性，如通过微服务网关或token限制访问）。

  4. 触发配置刷新： 当需要加载新的配置时，有两种方式：手动触发和使用 webhook 自动触发。

    • 手动触发： 使用 HTTP 客户端（如 curl 或 Postman）发送 POST 请求到 任意一个微服务实例的 /actuator/bus-refresh 端点。通常选定 Config Server 自身或者某一个服务来触发即可。例如：

      POST http://localhost:8888/actuator/bus-refresh

      bash

      （如果 Config Server 没有开启 Bus，则可以选择任意一个已引入 Bus 的微服务实例地址替换上述URL）。收到请求后，该实例会从远程仓库拉取最新配置，并通过消息总线将刷新事件广播给其他所有微服务​blog.csdn.net​blog.csdn.net。各个微服务收到事件后都会重新到配置中心获取新配置并更新自身配置（需要配合 @RefreshScope 生效）。整个过程实现了集群配置的“一键刷新”。

    • 自动触发（可选）： 可以利用代码仓库的 WebHooks 功能。当 Gitee 上的配置仓库有新的提交时，让其自动向应用的 /actuator/bus-refresh 发送一个POST请求。这样开发人员每次push配置更改后，系统就能自动完成刷新，而无需手动调用接口​blog.csdn.net。配置WebHook时需要提供一个可以访问应用的URL；若应用在内网不可直接访问公网，可以借助代理或公网网关来转发。由于直接暴露敏感端点有安全风险，可以考虑在应用层添加一个自定义受限的刷新接口映射到 /actuator/bus-refresh（如将 WebHook 指向一个受保护的URL，再由应用内部转发调用 bus-refresh）​blog.csdn.net​blog.csdn.net。根据实际需求决定是否启用 WebHook 自动化。

  5. 验证刷新效果： 可在客户端微服务中设置一个接口读取某配置值用于测试。例如创建一个简单的 Controller 返回配置属性值。启动 Eureka、Config Server、RabbitMQ 和两个实例的客户端微服务。修改 Gitee 仓库中的配置文件内容并提交，然后触发 /actuator/bus-refresh。几秒钟后，再次调用客户端的测试接口，应当看到配置值已经更新，且所有客户端实例都同步刷新​blog.csdn.net​blog.csdn.net。这样就确认了 Spring Cloud Bus 自动刷新配置的功能。

注意：

  • 使用 Spring Cloud Bus 需要确保所有相关服务都连接到了同一个消息代理（RabbitMQ/Kafka），否则消息无法传递。启动时可以在 RabbitMQ 管理界面观察到 Spring Cloud Bus 为每个实例创建的队列和交换机​github.com​github.com。

  • 如果对安全要求高，不想直接暴露 /bus-refresh 给外部，可仅在内部网络调用，或者在触发刷新时要求认证（可以结合 Spring Security 或 Gateway 实现）。

  • 对于不频繁更改的配置，也可以不使用消息总线，每次改动后通过手动调用各个实例的 /actuator/refresh 接口或重启服务来加载新配置。但在微服务较多时效率低，推荐使用 Bus。

  • 若引入 Spring Cloud Bus 后应用启动报 RabbitMQ 连接错误，检查 RabbitMQ 服务是否启动并且配置是否正确。必要时可以在配置中指定 spring.rabbitmq.addresses（含虚拟主机等高级选项）或者使用 Kafka 替代。

六、版本选择和依赖管理

本指南示例采用 Spring Boot 2.7.x + Spring Cloud 2021.x (Jubilee) 版本组合。这是一个经过长期支持（LTS）的稳定组合​spring.io。在 Maven 中，可以通过引入 Spring Cloud 2021 的 BOM 来管理依赖版本，以确保 Eureka、Config、Bus 等组件的兼容性​javafullstackdev.medium.com。例如，在 pom.xml 中：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.15</version>  <!-- Spring Boot 2.7.x 最新版本 -->
</parent>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2021.0.5</version> <!-- Spring Cloud 2021.x 最新发布版本 -->
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

通过以上方式引入依赖，无需手动指定各个 Spring Cloud 组件的版本。Spring Cloud 2021 版与 Spring Boot 2.7.x 完美兼容​spring.io。如果需要使用 Spring Boot 3.x，则应升级到 Spring Cloud 2022.x 或更高版本以获得官方支持。由于 Spring Boot 3+ 需要 Java 17 且对部分组件有变更（如不再直接包含 Netflix Eureka，需要单独引入兼容），在此不作展开。对于新项目，2.7.x + 2021.x 组合稳定且社区资料丰富，适合入门实践。

依赖版本推荐： Spring Boot 2.7.15（2025年最新补丁），Spring Cloud 2021.0.5 或 2021.0.6（Jubilee SR版），Spring Cloud Alibaba 2021.x（如果使用阿里巴巴组件，可选）。确保使用 Maven Central 可用的正式版本，并避免混用不兼容的版本。如果不确定版本兼容性，可参考 Spring 官方发布的兼容性说明​spring.io​spring.io。

七、常见错误及排查方法

在搭建和运行 Eureka 注册中心与配置中心的过程中，可能会遇到一些常见问题。以下列出若干典型错误场景及解决思路：

  • 无法连接 Eureka Server： 微服务启动时报错无法注册，或 Eureka 控制台看不到服务。首先检查微服务的 Eureka 客户端配置的 defaultZone URL 是否正确（地址和端口是否指向 Eureka Server）​blog.csdn.net。确保 Eureka Server 已启动且端口开放。其次，查看微服务日志，有没有出现 “Cannot execute request on any known server” 或类似错误。如果有，可能是 Eureka Server 地址不可达或者网络延迟过高。排查服务器防火墙或网络配置。在本地开发环境，注意不要同时启动多个 Eureka Server 实例占用端口。单节点模式下 Eureka Server 日志可能提示自身注册被跳过（因为我们设置了不注册自己），这是正常现象。

  • 配置中心无法拉取 Git 仓库： Config Server 启动时报错，常见信息如 “I/O error on Git operation”、“Authentication failed” 或 “reject HostKey”。

    • 若是 认证失败，请核实提供的用户名密码是否正确（特别是 Token 是否有正确的权限）。可以尝试用相同的 URL 和凭证在同一台机器上手动执行 git clone，确认仓库可访问​blog.csdn.net。如果手动也失败，则问题在于凭证或网络。

    • 若是 HostKey 拒绝（使用 SSH方式），按照前文步骤配置本机的 SSH 公私钥，并在 Gitee 上添加公钥​blog.csdn.net。或者改用 HTTPS 模式访问。

    • 若 Config Server 提示找不到某个配置文件（HTTP 404），检查仓库中是否存在对应的 {application}-{profile}.yml 文件，以及 Config Client 请求的 application name 和 profile 是否拼写正确。

    • 如果 Config Server 长时间不刷新配置（缓存问题），可以尝试重启 Config Server，或者在其上调用 /actuator/refresh（需要引入 Actuator 并暴露）来强制清除缓存。

  • 客户端获取配置失败： 如果微服务启动时没有成功从配置中心获取配置，表现为配置没有生效或应用直接启动了默认配置。请检查 Config Client 的 bootstrap.yml 是否放置正确（注意：在 Spring Boot 2.4+，默认不再启用 bootstrapContext，需要确保引入了 spring-cloud-starter-bootstrap 或正确配置了 spring.config.import）​github.com​github.com。为了简化，可继续使用 bootstrap.yml 来提前加载。确认其中的 spring.cloud.config.uri 能访问，并且 profile 和应用名正确。还可以查看微服务启动日志中有没有 "Fetching config from server" 之类的记录；如果完全没有相关日志，可能是 Config Client 没有启用（依赖缺失或配置文件名不对）。另外，若 Config Server 使用了自签名证书的HTTPS，客户端可能需要信任证书。

  • 配置刷新无效： 调用了 /actuator/refresh 或 /actuator/bus-refresh 后，发现客户端配置未更新。可能原因：

    • 没有在需要刷新的 Bean 上添加 @RefreshScope，导致新的配置值拉取后没有注入到现有Bean中。解决办法：对使用配置的组件加上 @RefreshScope​blog.csdn.net并确保刷新时该组件会重建或重新读取配置。

    • 如果使用 Bus，可能是消息总线未正确配置。检查 RabbitMQ 是否连通，每个服务是否都引入了 spring-cloud-starter-bus-amqp。可以在 RabbitMQ 管理控制台观察 springCloudBus 交换机下是否有队列绑定​github.com​github.com。如果没有，说明有服务未正确连接总线。

    • /actuator/bus-refresh 返回404或无法访问：确认已经在 Config Server 或某个客户端的 management.endpoints.web.exposure.include 中包含了 bus-refresh​github.com。Spring Boot 2.x默认只开放健康和info，需要手动开放bus-refresh端点。确保使用 POST 请求访问，而非 GET。

    • Gitee 仓库的配置修改后未生效：确认修改已提交推送到远程仓库，并且使用正确的方法触发了刷新（手动调用或 WebHook）。有时忘记推送代码到远程就刷新，会导致 Config Server 仍然返回旧配置。

  • 其他错误：

    • 端口冲突：确保 Eureka Server (8761)、Config Server (默认8888) 和各微服务的端口互不冲突。如果端口被占用，启动会失败或注册不上。调整 server.port 配置即可。

    • 版本不兼容：如果使用了不匹配的 Spring Boot 和 Spring Cloud 版本，可能出现类找不到或启动报错。请按照上述推荐版本使用，或者参考 Spring Cloud 官方兼容列表确保依赖匹配​spring.io。

    • Eureka 自我保护模式：Eureka Server 如果检测到短时间内大量服务心跳丢失，会进入自我保护模式，不清除过期实例。这在网络不稳定时可能导致已下线的服务仍然显示为UP。可以在 Eureka Server 配置中关闭自我保护（eureka.server.enable-self-preservation: false）用于测试环境，但生产环境建议保留默认保护机制。

通过以上步骤和注意事项，基本可以完成一个 Spring Cloud 微服务架构中服务注册中心和配置中心的搭建，并实现配置的集中管理与动态刷新。在实际项目中，根据需要还可以引入网关、负载均衡、熔断等组件，但有了注册中心和配置中心，已经为微服务体系奠定了基础。希望这份资料能帮助你顺利搭建环境，避免踩坑。如遇问题，可结合日志信息及上述排查方法定位解决。祝搭建成功！

标签
#java #开发语言
人工智能算法合集-python实现
03-04
人工智能算法合集，用python3实现，运行在notebook上，注解详细，包括聚类、神经网络等算法
使用python实现人工智能算法
07-10
使用python实现了各种机器学习的算法，也有通过tensorflow实现CNN
AI人工智能中的数学基础原理与Python实战：11. 统计学的基础知识
东海陈光剑的博客：禅与计算机程序设计艺术
12-05 528
1.背景介绍 统计学是人工智能中的一个重要分支，它涉及到数据的收集、处理、分析和解释。在人工智能中，统计学被广泛应用于机器学习、数据挖掘和预测分析等领域。本文将介绍统计学的基础知识，包括概率论、数学统计学和统计推断等方面。 2.核心概念与联系 2.1概率论
统计学与人工智能：结合的力量
东海陈光剑的博客：禅与计算机程序设计艺术
12-27 4508
1.背景介绍 人工智能(Artificial Intelligence, AI)是一门跨学科的研究领域，它旨在构建智能系统，使其能够自主地执行复杂的任务，并与人类相互作用。人工智能的主要目标是模仿、扩展或者替代人类的智能能力。统计学(Statistics)是一门数学和方法学的学科，它主要研究数据的收集、分析和解释。统计学在人工智能领域具有重要的作用，因为它提供了一种方法来处理和分析大量的数据，从...
python人工智能算法的方式_学习人工智能必须攻克三道门槛
weixin_39626745的博客
11-24 558
广义的说，人工智能包含诸多不同方法，其主旨是让程序像一个智能体一样解决问题。机器学习是实现人工智能的一种方法，它不完全依靠预先设计，而是从数据中进行总结，达到模拟记忆、推理的作用。包括诸如支持向量机(SVM)、各类基于决策树的算法(包括Boosting、Bagging、Random Forest等)，各类基于人工神经网络的算法(例如简单网络及深度网络等)，以及多方法的集成等。基于人工智能的发展优势...
AI算法(机器学习)的基本原理
码农先锋的博客
01-09 2万+
无论是简单的线性模型，还是复杂的神经网络，抑或是LLM大语言模型，其本质都是一个函数。这个函数可能非常复杂，可能是非线性的，也可能是非连续的。如目标函数是一个简单的线性函数f(x) = wx + b, 则w,b就是我们要求的函数的系数，也称模型的参数。
十大人工智能经典算法代码python
longe20111104的博客
04-03 3858
十大人工智能经典算法代码python
李航《统计学习方法》第三章——用Python实现KNN算法（MNIST数据集）
wds2006sdo的专栏
07-17 2万+
相关文章： 李航《统计学习方法》第二章——用Python实现感知器算法（MNIST数据集） 李航《统计学习方法》第四章——用Python实现朴素贝叶斯分类器（MNIST数据集） 看了第三章 k近邻法 (k-nearest neighbor, k-NN) ， 发现KNN算法真的好适合在MNIST数据集上分类。因为KNN实际上就是一个少数服从多数的投票模型，所以可以用在多分类的
Python 机器学习 K-近邻算法
weixin_42098295的博客
01-30 1958
它是一种基于实例的学习（Instance-based learning），或者称为懒惰学习（Lazy learning），因为它不会从训练数据中学习一个固定的模型，而是使用整个数据集进行预测。在回归问题中，则通常是这些邻居值的平均值。选取合适的K值是至关重要的，太小的K值会使模型对噪声敏感，而太大的K值可能使模型无法捕捉到数据的特性。参数指定了计算最近邻的方法，可选项包括 'auto', 'ball_tree', 'kd_tree', 'brute'，其中'auto'会自动选择最适合数据的算法。
人工智能是一种理想技术吗？
东海陈光剑的博客：禅与计算机程序设计艺术
09-20 2053
作者：禅与计算机程序设计艺术 1.简介 人工智能(AI)是一个历史悠久的概念,但近年来却开始走向实用化。越来越多的人开始关注、认可和应用人工智能技术来提升工作效率、改善生活品质、实现自我价值,并期待其带来新的商业领域、科技成果和社会影响。那么，人工智能到底是什么？它真的是一种理想技术吗？本文将对人工智能
数据处理和分析之分类算法：K近邻算法(KNN)：数据科学导论
最新发布
2401_87715305的博客
09-28 1433
问题定义：明确项目目标，确定需要解决的问题。数据收集：从各种来源收集相关数据。数据清洗：处理缺失值、异常值，确保数据质量。数据探索：通过统计和可视化手段理解数据的特征和分布。特征工程：选择、构建和优化用于模型训练的特征。模型选择与训练：选择合适的算法，训练模型以预测或分类。模型评估：使用测试数据评估模型的性能。模型部署：将模型应用到实际场景中，进行实时或批量预测。结果解释与报告：解释模型结果，撰写报告，向非技术团队成员传达发现。
AI人工智能原理与Python实战：Python人工智能算法介绍
东海陈光剑的博客：禅与计算机程序设计艺术
12-13 442
1.背景介绍 人工智能（Artificial Intelligence，AI）是计算机科学的一个分支，研究如何让计算机模拟人类的智能。人工智能的目标是让计算机能够理解自然语言、学习从数据中提取信息、解决问题、自主决策、理解人类的情感、理解和模拟人类的行为和思维过程。 人工智能的历史可以追溯到1956年，当时的科学家们提出了“人工智能原则”
人工智能算法之python基础
jcjbusbjk的博客
05-05 2801
一、numpy函数 别人整理的numpy函数大全 重点 1.ndarray 用各种routines创建各种样式的ndarray 把任何东西，图片、音频、视频等当作矩阵看待，用矩阵运算去处理它
图解AI数学基础(2) | 概率与统计（要点速查清单·完结）
ShowMeAI研究中心
02-25 1万+
机器学习会更多地使用概率论处理不确定量或随机量，很多典型的机器学习算法也是基于概率的。本文将机器学习中常见的概率与统计知识做一个梳理：随机变量、随机向量、概率分布、条件概率、贝叶斯公式、期望、方差、协方差、相关系数、常见分布等。......
AI统计学-数据科学、机器学习、人工智能基础
lqfarmer的博客
10-24 1361
本书介绍 本书最初于2016年开始编写，当时为昆士兰大学的统计学习课程准备材料。当时，Julia语言已经是一款非常实用的工具，即使它的版本仅为0.5。自从那时起，就像在2020年一样，R语言在统计领域占据着主导地位，就像Python在机器世界占据了主导地位一样。 bshq：AI统计学新书-《数据科学、机器学习、人工智能基础》免费pdf分享 为什么选择Julia语言，主要有以下三个原因：性能，简单性和灵活性。Julia正在迅速成为数据科学，统计，机器学习，人工智能和通用科...
【Python】 python | 人工智能 | ai | 回归算法
hgSuper的博客
12-28 1426
一、概述 1、回归算法理解，回归算法，即回归出数据中的规律（解模型） 2、回归算法可能存在过拟合情况 3、只是初学，未能深究 4、课程推荐，慕课-零基础学Python 二、演示代码 import numpy as np import matplotlib.pyplot as plt # 回归算法 t = np.arange(1, 10, 1) y = 0.9 * t + np.sin(t) plt.plot(t,...
使用Python创建AI比你想象的轻松
热门推荐
Lunaqi的博客
07-27 4万+
您可能对AI领域，主要开发阶段，成就，结果和产品使用感兴趣。有数百个免费源和教程描述使用Python的AI。但是，没有必要浪费你的时间看他们。这里是一个详细的指南，你需要知道在使用Python构建人工智能之前的所有点。 使用什么语言构建AI？ LISP是创造AI最流行的语言之一。其最佳功能包括垃圾回收，统一语法，动态类型和交互式环境。LISP代码是s表达式并由列表组成。 另一种广
AI从零开始之统计学简介
更多原创参见个人小站：http://www.donggeitnote.com/
05-21 1164
今天我们来看一下统计学主要是干些什么，在大家深入了解之前能够有一个感性的认识。要想感性（呃，不是性感），那最好的方法肯定是举个例子来说明了。我们经常说上学无用论，所谓有用无用，粗俗点理解就是能不能赚钱，现在我们假设知道了一些学历（或者说学习年数）和收入的数据，他们如果画图的话就会显示成下面的图一所示：图一 收入和学历之间的关系图现在我们假设收入就只和学历之间有关系，我们把收入写成Y，学历这里置为X...
10 种机器学习算法的要点（附 Python 和 R 代码）
onlyForCloud的专栏
10-08 5955
http://blog.jobbole.com/92021/ 本文由 伯乐在线 - Agatha 翻译，唐尤华 校稿。未经许可，禁止转载！ 英文出处：SUNIL RAY。欢迎加入翻译组。 前言 谷歌董事长施密特曾说过：虽然谷歌的无人驾驶汽车和机器人受到了许多媒体关注，但是这家公司真正的未来在于机器学习，一种让计算机更聪明、更个性化的技术。 也许我们生活在人
AI算法实现五子棋
weixin_42372777的博客
08-05 1万+
首先，实现一个五子棋要有一个棋盘，然后在这个棋盘上我们再来画出图画，五子棋棋盘有固定的行数和列数，再加上界面的大小和菜单栏，这些数据可能很多个类都需要用到，我们可以先考虑自己写一个接口用来存储这些数据： public interface Config { public static final int SIZE=703; //面板大小 public static final int ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值