tencent cloud

注册配置治理

文档注册配置治理Polaris（北极星）Java 应用开发Spring Cloud 应用开发动态路由

动态路由

PDF
聚焦模式
字号
最后更新时间： 2026-05-08 14:26:44

操作场景

本文介绍在本地开发 Java 应用，通过 Spring Cloud 的方式接入 Polaris（北极星），并实现服务路由。

前提条件

1. 在开发前，请确保您已经下载安装了 Java 和 Maven。
2. 已创建 Polaris（北极星）实例，操作步骤详见 北极星实例管理。

操作步骤

步骤1：引入依赖

1.1 引入 spring cloud tencent 依赖

修改应用根目录下的 pom.xml，添加dependencyManagement：
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.tencent.cloud</groupId>
            <artifactId>spring-cloud-tencent-dependencies</artifactId>
            <version>${version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
注意：
请根据项目 Spring Boot 和 Spring Framework 的版本，选择合适的 Spring Cloud Tencent 版本。

1.2 引入 spring cloud tencent starter

方式一：通过 spring-cloud-starter-tencent-all 引入 sct 所有 starters。
<dependency>
    <groupId>com.tencent.cloud</groupId>
    <artifactId>spring-cloud-starter-tencent-all</artifactId>
</dependency>
方式二：同时引入 spring-cloud-starter-tencent-polaris-discovery 和 spring-cloud-starter-tencent-polaris-router。
<dependency>
    <groupId>com.tencent.cloud</groupId>
    <artifactId>spring-cloud-starter-tencent-polaris-discovery</artifactId>
</dependency>

<dependency>
    <groupId>com.tencent.cloud</groupId>
    <artifactId>spring-cloud-starter-tencent-polaris-router</artifactId>
</dependency>

步骤2：添加北极星配置文件

1. 在项目的 main/resources 目录下创建 bootstrap.yml 文件。
2. 在 bootstrap.yml 文件中配置应用名、Polaris（北极星）服务端地址等信息。服务端地址查看详见 引擎管理 的客户端访问地址部分。
spring:
  application:
    name: ${application.name}
  cloud:
    polaris:
      enabled: true
      address: grpc://${修改为 Polaris 服务地址}:8091
      namespace: default
      router:
        metadata-router:
          enabled: true

步骤3：路由规则下发

启动应用并在 北极星控制台 设置动态路由规则，操作步骤详细参见 服务治理指南 > 服务治理 > 动态路由，相关界面如下：






上一篇: 服务熔断下一篇: 无损上下线

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈