docker-minecraft-server 项目：解决 All the Mods 10 模组包安装错误问题

问题背景

在使用 docker-minecraft-server 项目部署 All the Mods 10 (ATM10) 模组包时，用户遇到了安装失败的问题。错误信息显示"More than one mod found with slug="，导致服务器无法正常启动。这个问题出现在尝试更新到 ATM10 2.25 版本时。

错误分析

通过日志分析，我们发现错误发生在模组包安装过程中，具体表现为：

1. 系统报告"More than one mod found with slug="错误
2. 错误发生在 CurseForge API 调用过程中
3. 问题与模组排除列表(CF_EXCLUDE_MODS)的格式有关

根本原因

经过深入排查，发现问题出在环境变量 CF_EXCLUDE_MODS 的设置上。用户使用了以下格式：

CF_EXCLUDE_MODS: 986380, 520110, 394468, 447673, 927064

问题在于：

1. 模组ID之间包含了空格
2. 这些额外的空格导致解析器无法正确识别单个模组ID
3. 最终导致系统无法准确匹配要排除的模组

解决方案

要解决这个问题，有两种方法：

方法一：移除空格

将 CF_EXCLUDE_MODS 修改为不含空格的格式：

CF_EXCLUDE_MODS: 986380,520110,394468,447673,927064

方法二：使用数组格式

在 docker-compose 文件中，可以使用 YAML 数组格式：

CF_EXCLUDE_MODS:
  - 986380
  - 520110 
  - 394468
  - 447673
  - 927064

技术细节

1. 模组ID解析机制：docker-minecraft-server 在处理模组排除列表时，会将这些ID作为参数传递给 CurseForge API。API要求ID必须准确无误，任何额外的字符都会导致匹配失败。

2. 错误处理机制：当系统检测到多个模组匹配同一个ID时，会抛出"More than one mod found"异常，这是一种保护机制，防止错误地排除或包含模组。

3. 环境变量处理：在容器环境中，环境变量的值会被直接传递给内部处理程序，因此格式要求严格。

最佳实践建议

1. 在配置模组排除列表时，避免在ID之间使用空格
2. 考虑使用YAML数组格式，可读性更好且不易出错
3. 对于复杂的模组包配置，建议先在测试环境中验证
4. 定期检查模组ID是否仍然有效，因为有些模组可能会更新或被移除

总结

这个案例展示了在配置容器化Minecraft服务器时，环境变量格式的重要性。即使是看似无害的空格，也可能导致整个模组包安装失败。通过理解错误背后的机制，我们可以更好地配置和维护我们的游戏服务器。

对于 docker-minecraft-server 用户来说，遵循严格的配置格式要求是确保服务器稳定运行的关键。项目维护者也正在改进相关代码，以更好地处理这类格式问题。