Cardano-node测试网中Conway创世配置委员会成员缺失问题分析

问题背景

在Cardano-node项目的测试网功能中，开发人员发现了一个关于Conway时代创世配置的重要问题。当用户尝试通过修改默认Conway创世配置来添加委员会成员时，这些修改无法正确反映到最终生成的conway-genesis.json文件中。

问题现象

开发人员观察到以下异常现象：

1. 在用户提供的genesis.conway.spec.json文件中，委员会成员配置正确显示
2. 但在实际生成的conway-genesis.json文件中，委员会成员列表却为空
3. 查询链上数据时也返回空列表，表明委员会成员确实未被正确初始化

技术分析

经过深入调查，发现问题根源在于cardano-testnet与cardano-cli子模块之间的交互逻辑：

1. cardano-testnet调用cardano-cli的create-testnet-data命令生成测试网数据
2. 该命令会基于--committee-keys参数而非输入文件中的委员会配置来生成最终结果
3. 当参数未明确指定时，默认使用空委员会配置，覆盖了用户原本的配置

解决方案演进

项目团队提出了多个解决方案并经历了以下演进过程：

1. 初始修复方案：尝试修改create-testnet-data命令的行为，使其尊重输入文件中的委员会配置
2. 设计调整：最终决定采用更彻底的解决方案，引入UserProvidedOrigin机制
   • 允许用户完全控制创世文件内容
   • 避免混合默认配置与用户配置导致的潜在冲突
3. 兼容性考虑：为平滑过渡，同时提供了getDefaultGenesisBatch接口

使用建议

对于需要使用自定义Conway创世配置的开发人员：

1. 明确使用UserProvidedOrigin标识自定义配置
2. 确保提供完整的创世配置，包括所有必要字段
3. 注意某些字段（如genDelegs和initialFunds）在自定义模式下需要手动填充

经验总结

这个问题的解决过程展示了分布式系统配置管理的几个重要原则：

1. 配置来源单一性：避免同一配置项有多个可能的来源
2. 明确职责划分：工具链各组件应有清晰的职责边界
3. 用户控制与便利性的平衡：在提供默认便利的同时，保留用户完全控制的能力

该修复已合并到Cardano-node主分支，为Conway时代的测试网开发提供了更可靠的配置管理机制。