Terracotta Server 10.11卡在DIAGNOSTIC状态无法进入ACTIVE状态求助

问题原因 #

Terracotta 5.x及后续版本采用了Nomad动态配置系统，服务器启动时会先加载配置进入DIAGNOSTIC模式，等待配置被显式提交确认后，才会切换到ACTIVE模式对外提供服务。旧版本Terracotta没有这个机制，会自动完成初始化直接进入ACTIVE状态，这是新版本为保障配置一致性设计的差异。

从日志中的Starting unconfigured node: default-node可明确，当前服务器仅加载了配置文件，但未完成配置提交流程，因此停留在DIAGNOSTIC状态。

解决方法 #

方法1：启动后手动提交配置 #

在服务器处于DIAGNOSTIC状态时，使用Terracotta自带的配置工具提交配置：

1. 进入Terracotta Server的server/bin目录
2. 执行以下命令：

   tc-config.bat apply -f C:\Users\user\Downloads\ehcache-clustered-3.10.0-kit\ehcache-clustered-3.10.0-kit\server\conf\cluster.cfg -s localhost:9410
   

3. 查看服务器日志，出现如下日志则表示激活成功：

   2022-11-24 XX:XX:XX,XXX INFO - Moved to State[ ACTIVE ]
   

方法2：启动时自动初始化集群 #

在启动命令中添加-n参数，让服务器启动时自动完成配置提交，直接进入ACTIVE状态：

start-tc-server.bat -f C:\Users\user\Downloads\ehcache-clustered-3.10.0-kit\ehcache-clustered-3.10.0-kit\server\conf\cluster.cfg -n

-n参数的作用是自动初始化新集群，跳过手动提交步骤。

验证 #

服务器进入ACTIVE状态后，Spring Boot应用的TimeoutException问题会自动解决，此时服务器可正常接收客户端连接。

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