Sitecore Docker启动报错 traefik容器不健康问题排查

个人笔记本上Docker运行基本正常，仅偶发如下启动错误：

ERROR: for traefik  Container "64e4a46ba760" is unhealthy.
ERROR: Encountered errors while bringing up the project.

此前偶发时按以下步骤操作即可修复：

• 执行docker down命令
• 退出Docker客户端
• 清空deploy文件夹内的所有内容
• 重新启动Docker服务
• 执行docker up命令拉起环境

近期在另一台笔记本部署相同Docker环境时，上述traefik容器不健康、项目启动失败的问题持续出现，重复以上步骤无效，进一步做了如下排查：

• 执行docker ps获取异常traefik容器的ID
• 执行docker inspect <容器ID>查询容器详情，拿到容器内部IP地址
• 直接访问<容器IP地址>/healthz/ready健康检查端点，拿到如下错误返回：

"InnerException": {
"Message": "An error has occurred.",
"ExceptionMessage": "String was not recognized as a valid Boolean.",
"ExceptionType": "System.FormatException",
"StackTrace": "   at System.Boolean.Parse(String value)"
}

当前使用的Traefik版本为4.5.1。

大量开发者遇到过同类问题，问题根源分两类：

1. 偶发场景（旧笔记本的情况）：deploy目录下残留了上次运行生成的损坏临时配置缓存，Traefik启动时读取到非法配置值，导致健康检查逻辑执行失败，清空缓存重启后配置重新生成即可恢复正常。
2. 持续触发场景（新笔记本的情况）：4.5.1版本的Traefik健康检查模块基于.NET实现，解析布尔类型配置项时没有指定固定区域格式化规则，当宿主机系统区域设置为非英文（比如简体中文、日文等），或者部署配置里给布尔类参数传了带多余引号、首尾空格、大小写不匹配的值时，Boolean.Parse方法就会抛出格式异常，导致健康检查接口始终返回错误，容器被Docker判定为不健康，最终项目启动失败。这类属于环境/版本导致的必现问题，单纯清缓存、重启Docker无法解决。

按优先级依次操作即可：

• 第一步先检查所有部署配置（包括docker-compose.yml、.env环境变量文件、Traefik动态配置文件）里的布尔类型参数（比如api.insecure、insecureSkipVerify、各类开关类配置项），确保参数值是不带任何引号、没有首尾空格的小写true或false，不要写成"true"、True、false 这类不符合解析要求的格式。
• 不想升级版本的话可以临时规避：给Traefik容器添加环境变量DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true，强制.NET运行时使用与区域无关的格式化规则做类型解析，绕开非英文系统下的布尔解析bug。
• 永久解决的话直接把Traefik升级到4.5.2及以上稳定版本，官方已经在后续补丁中修复了该解析逻辑的缺陷。
• 如果升级后仍有极低概率偶发报错，可以在容器启动配置中增加3-5秒的启动延迟，避免配置文件尚未加载完成时健康检查提前探测导致的误判。

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