Terracotta 10.7重启后无法启动：指定服务器名不存在于tc-config文件

核心排查与修复步骤 #

根据日志提示的You have specified server name ‘serverName’ which does not exist in the specified tc-config file，问题根源是启动时指定的服务器名与tc-config配置文件中的定义不匹配，以下是针对性操作：

1. 精准核对tc-config.xml的服务器名称配置 #

找到Terracotta配置目录下的tc-config.xml，检查<server>节点的name属性，确保与启动时指定的名称完全一致（注意大小写、全角/半角符号、空格等细节）：

<!-- 示例正确配置 -->
<server name="your-real-server-hostname" bind="0.0.0.0" port="9510">
  <!-- 其他节点配置 -->
</server>

2. 检查启动参数与wrapper配置的一致性 #

• 除了parameter.6，排查wrapper.conf中所有wrapper.app.parameter.*项，确认没有其他传递服务器名的参数（如-n或--server-name）与预期值冲突
• 直接查看启动脚本（start-tc-server.sh/start-tc-server.bat），确认脚本中是否硬编码了错误的服务器名参数

3. 强制指定配置文件加载路径 #

Terracotta可能加载了旧配置而非你修改的版本，启动时显式指定配置文件路径：

# Linux/macOS
./start-tc-server.sh -f /path/to/your/modified/tc-config.xml -n your-real-server-hostname

# Windows
start-tc-server.bat -f C:\path\to\your\modified\tc-config.xml -n your-real-server-hostname

4. 排查环境变量的干扰 #

检查是否存在环境变量覆盖服务器名配置：

# Linux/macOS
echo $TC_SERVER_NAME

# Windows
echo %TC_SERVER_NAME%

若输出非预期值，执行unset TC_SERVER_NAME（Linux）或set TC_SERVER_NAME=（Windows）清除后重启。

5. 验证tc-config的语法与编码 #

• 用XML校验工具检查tc-config.xml是否存在语法错误（如未闭合标签、属性引号不匹配）
• 确认配置文件为UTF-8无BOM格式，避免特殊字符导致解析异常

应急恢复方案 #

若需紧急恢复服务，可临时使用tc-config中已存在的服务器名（如默认的localhost）启动：

./start-tc-server.sh -n localhost

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