Seata Failed to get available servers: endpoint format should like ip:port 报错原因/解决方案汇总版（看完本文必解决问题）

朴灿烈づ我的快乐病毒、 2023-10-04 19:13 3阅读 0赞

#### 文章目录 ####

*  一、详细报错信息
 *  二、原因分析
 *   *  原因1：\`service.vgroupMapping\`配置的服务组名称不符合Seata默认要求；
     *  原因2：\`service.vgroupMapping\`配置的seata集群名称没有对应的grouplist
 *  三、解决方案
 *   *  方案1、将file.conf中service.vgroupMapping配置调整为\`$\{spring.application.name\}-seata-service-group\`；
     *  方案二、在application.yml中指定\`seata.tx-service-group\`
     *   *  spring.cloud.alibaba.seata.tx-service-group 和 seata.tx-service-group
 *  四、seata集群名称的坑

## 一、详细报错信息 ##

springcloud 集成 seata1.3.0 时报错：

2022-08-04 00:00:00.000 ERROR 78958 --- [eoutChecker_2_1] i.s.c.r.netty.NettyClientChannelManager  : Failed to get available servers: endpoint format should like ip:port
    
    java.lang.IllegalArgumentException: endpoint format should like ip:port
    	at io.seata.discovery.registry.FileRegistryServiceImpl.lookup(FileRegistryServiceImpl.java:95) ~[seata-all-1.3.0.jar:1.3.0]
    	at io.seata.core.rpc.netty.NettyClientChannelManager.getAvailServerList(NettyClientChannelManager.java:217) ~[seata-all-1.3.0.jar:1.3.0]
    	at io.seata.core.rpc.netty.NettyClientChannelManager.reconnect(NettyClientChannelManager.java:162) ~[seata-all-1.3.0.jar:1.3.0]
    	at io.seata.core.rpc.netty.AbstractNettyRemotingClient$1.run(AbstractNettyRemotingClient.java:106) [seata-all-1.3.0.jar:1.3.0]
    	at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) [na:1.8.0_275]
    	at java.util.concurrent.FutureTask.runAndReset(FutureTask.java:308) [na:1.8.0_275]
    	at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.access$301(ScheduledThreadPoolExecutor.java:180) [na:1.8.0_275]
    	at java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:294) [na:1.8.0_275]
    	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) [na:1.8.0_275]
    	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) [na:1.8.0_275]
    	at io.netty.util.concurrent.FastThreadLocalRunnable.run(FastThreadLocalRunnable.java:30) [netty-all-4.1.58.Final.jar:4.1.58.Final]
    	at java.lang.Thread.run(Thread.java:748) [na:1.8.0_275]

## 二、原因分析 ##

本文基于seata1.3.0版本，代表这1.X的版本，0.x版本的略有不同。

在文件类型的注册服务时，会通过`FileRegistryServiceImpl#lookup(String)`方法根据VgroupMapping的key去寻找可用的Seata-server实例；报错的体现正是无法根据`service.VgroupMapping`这个配置找到具体的Seata实例（IP:PORT信息）；

![在这里插入图片描述][8ce1d4e2db1f447f9c291f29b38d0a94.png]

**几个字符串常量值如下：**

String PREFIX_SERVICE_MAPPING = "vgroupMapping.";
            String PREFIX_SERVICE_ROOT = "service";
        String CONFIG_SPLIT_CHAR = ".";
        private static final String POSTFIX_GROUPLIST = ".grouplist";
        private static final String ENDPOINT_SPLIT_CHAR = ";";
        private static final String IP_PORT_SPLIT_CHAR = ":";

**获取当前服务组名称对应的seata集群名称的代码逻辑如下：**

![在这里插入图片描述][0d4447d9b1d04035be1c203499179c95.png]

针对 `service.vgroupMapping`，[官方案例：Spring Cloud 快速集成 Seata][Spring Cloud _ Seata]是这么说的：

![在这里插入图片描述][3955fe288e294612999382e1c8d4a96e.png]

**划重点：需要注意的是 `service.vgroupMapping`这个配置，在 Spring Cloud 中默认是`${spring.application.name}-fescar-service-group`**

![在这里插入图片描述][ca92635465084a4694e5359f0fbc5259.png]

**再看博主debug时的默认 `service.vgroupMapping`配置，居然是`${spring.application.name}-seata-service-group`；**

>  *  我程序的`spring.application.name`为`trade-center`
>  *  `service.vgroupMapping`的配置为`trade-center-seata-service-group`，**不说好的是`${spring.application.name}-fescar-service-group`吗！！！！！！！**

等下我们再继续说，先让我喷一会：`***********`，官方文档不更新的吗？不注意版本之间的差异吗？不标明版本差异吗？`******`。

**所以原因本质上只有一个：无法根据`service.VgroupMapping`这个配置找到具体的Seata实例（IP:PORT信息）；**但导致该原因产生的方式会有很多种；

### 原因1：`service.vgroupMapping`配置的服务组名称不符合Seata默认要求； ###

**前提：不在application.yml配置文件中手动通过`seata.tx-service-group`属性指定seata服务组名称。**

默认 `service.vgroupMapping`这个配置，在 Spring Cloud 中默认是`${spring.application.name}-seata-service-group`

所以，当我们未按`${spring.application.name}-seata-service-group`这个规则配置`service.vgroupMapping`时会报错。

**报错配置样例：**  
![在这里插入图片描述][910ab45c14ca4d44b19b400c92c8adcd.png]  
解决方案对应下面的方案一、方案二。

### 原因2：`service.vgroupMapping`配置的seata集群名称没有对应的grouplist ###

![在这里插入图片描述][c2beacc49a40410a9fced4cab9ec947b.png]

比如：这里我配置的`service.vgroupMapping`值为`seata-server-sh`，而配置的grouplist是属于`default`的；

所以报错是因为通过`service.vgroupMapping`配置找到seata集群名称`seata-server-sh`，但是`seata-server-sh`没有对应的grouplist，即seata实例信息。  
![在这里插入图片描述][36b55f5b83da4144b9854e14d04c9eca.png]

解决方案：把grouplist的的所属方调整为和`service.vgroupMapping`配置的seata集群名称一致；

## 三、解决方案 ##

### 方案1、将file.conf中service.vgroupMapping配置调整为`${spring.application.name}-seata-service-group`； ###

就博主程序而言，application.yml、file.conf配置如下：

**1> application.yml：**

spring:
      application:
        name: trade-center

**2> file.conf关键配置：**

![在这里插入图片描述][6612b5152c8b4390b8678f71764e4500.png]

### 方案二、在application.yml中指定`seata.tx-service-group` ###

就博主程序而言，application.yml、file.conf配置如下：

**1> application.yml：**

spring:
      application:
        name: trade-center
    seata:
      # tx-service-group的值一定要和file.conf中service.vgroupMapping配置对应上
      tx-service-group: saint_trade_tx_group

**或者使用：**

spring:
      application:
        name: trade-center
      cloud:
        alibaba:
          seata:
            # tx-service-group的值一定要和file.conf中service.vgroupMapping配置对应上
            tx-service-group: saint_trade_tx_group

**2> file.conf关键配置：**

![在这里插入图片描述][44e4a5751ea44a8bb42f46d92df42074.png]

**我们注意到可以使用`spring.cloud.alibaba.seata.tx-service-group` 或 `seata.tx-service-group` 属性指定`service.vgroupMapping`配置，为啥呢？**

#### spring.cloud.alibaba.seata.tx-service-group 和 seata.tx-service-group ####

`spring.cloud.alibaba.seata.tx-service-group` 属于`SpringCloudAlibabaConfiguration`类：

![在这里插入图片描述][bd043b241cc549ae8778d53c3c9e5adc.png]

`seata.tx-service-group` 属性属于`SeataProperties`类：

![在这里插入图片描述][6bd5b0c5ad7e493ebabf748bce541c88.png]

而`SeataProperties`类又被注解`@EnableConfigurationProperties(SpringCloudAlibabaConfiguration.class)`标注，所以会使`SpringCloudAlibabaConfiguration`的配置生效；又`SeataProperties`类中通过`@Autowired`的方式组合了`SpringCloudAlibabaConfiguration`，在通过`getTxServiceGroup()`方法获取`txServiceGroup`属性时如果`SeataProperties`类自己没有配置`txServiceGroup`，则从`SpringCloudAlibabaConfiguration`中获取；

![在这里插入图片描述][b6cd756268fd49cc8a7fff21960fac3c.png]

简单来说；就是优先取 `seata.tx-service-group` 属性值，没有则再取`spring.cloud.alibaba.seata.tx-service-group`属性值。

## 四、seata集群名称的坑 ##

seata-server和 项目程序 部署在不同的机器上时，可能会出现 `can not connect to services-server`。

如果配置的 `default.grouplist` = “192.168.7.254:8091”，则并不会生效，`default.grouplist`读取的还是默认的`127.0.0.1:8091`；

**建议把seata集群名称调整为非dafault，例如：**

service {
        
      vgroupMapping.saint_trade_tx_group = "seata-server-sh"
      seata-server-sh.grouplist = "127.0.0.1:8091"
    }

[8ce1d4e2db1f447f9c291f29b38d0a94.png]: https://img-blog.csdnimg.cn/8ce1d4e2db1f447f9c291f29b38d0a94.png
[0d4447d9b1d04035be1c203499179c95.png]: https://img-blog.csdnimg.cn/0d4447d9b1d04035be1c203499179c95.png
[Spring Cloud _ Seata]: https://github.com/seata/seata-samples/blob/master/doc/quick-integration-with-spring-cloud.md
[3955fe288e294612999382e1c8d4a96e.png]: https://img-blog.csdnimg.cn/3955fe288e294612999382e1c8d4a96e.png
[ca92635465084a4694e5359f0fbc5259.png]: https://img-blog.csdnimg.cn/ca92635465084a4694e5359f0fbc5259.png
[910ab45c14ca4d44b19b400c92c8adcd.png]: https://img-blog.csdnimg.cn/910ab45c14ca4d44b19b400c92c8adcd.png
[c2beacc49a40410a9fced4cab9ec947b.png]: https://img-blog.csdnimg.cn/c2beacc49a40410a9fced4cab9ec947b.png
[36b55f5b83da4144b9854e14d04c9eca.png]: https://img-blog.csdnimg.cn/36b55f5b83da4144b9854e14d04c9eca.png
[6612b5152c8b4390b8678f71764e4500.png]: https://img-blog.csdnimg.cn/6612b5152c8b4390b8678f71764e4500.png
[44e4a5751ea44a8bb42f46d92df42074.png]: https://img-blog.csdnimg.cn/44e4a5751ea44a8bb42f46d92df42074.png
[bd043b241cc549ae8778d53c3c9e5adc.png]: https://img-blog.csdnimg.cn/bd043b241cc549ae8778d53c3c9e5adc.png
[6bd5b0c5ad7e493ebabf748bce541c88.png]: https://img-blog.csdnimg.cn/6bd5b0c5ad7e493ebabf748bce541c88.png
[b6cd756268fd49cc8a7fff21960fac3c.png]: https://img-blog.csdnimg.cn/b6cd756268fd49cc8a7fff21960fac3c.png