Git-Commit-ID-Maven-Plugin 8.0.0+版本在多模块项目中生成空git.properties文件问题分析

在Maven多模块项目中使用git-commit-id-maven-plugin时，开发者可能会遇到一个奇怪的问题：当配置了injectAllReactorProjects=true参数时，子模块中生成的git.properties文件内容为空。这个问题从8.0.0版本开始出现，而7.0.0版本则表现正常。

问题现象

当开发者在多模块Maven项目中配置git-commit-id-maven-plugin，并启用injectAllReactorProjects选项后，期望所有模块都能获取到相同的Git版本信息。然而在实际使用中，从8.0.0版本开始，子模块生成的git.properties文件仅包含注释头部，没有实际的Git信息内容。

问题根源

经过深入分析，这个问题源于8.0.0版本中的一个内部实现变更。在7.0.0版本中，插件直接使用上下文属性对象，而在8.0.0版本中改为创建新的Properties对象并传入上下文属性作为默认值。

具体来说，8.0.0版本使用了以下代码：

properties = new Properties(contextProperties);

而7.0.0版本则是：

properties = contextProperties;

问题出在Java的Properties类实现上。当使用带有默认值的构造函数时，虽然文档表明这会创建一个包含指定默认值的新属性列表，但实际上在某些情况下这些默认值不会如预期那样可用。这导致了上下文属性虽然正确填充，但新创建的Properties对象却为空。

解决方案

项目维护者提出了一个有效的修复方案，改为使用以下方式：

properties = new Properties();
properties.putAll(contextProperties);

这种方法明确地将所有上下文属性复制到新的Properties对象中，确保了属性值的正确传递。这个修复已经包含在9.0.1版本中。

影响范围

这个问题影响了从8.0.0开始的所有版本，包括8.0.2和9.0.0。对于使用这些版本的多模块项目，如果配置了injectAllReactorProjects=true，就会遇到子模块git.properties文件为空的问题。

临时解决方案

对于暂时无法升级到9.0.1版本的项目，可以考虑以下临时解决方案：

1. 降级使用7.0.0版本
2. 暂时关闭injectAllReactorProjects选项，改为在每个模块中单独生成Git信息

最佳实践

为了避免类似问题，建议开发者：

1. 在使用新版本插件前，先在测试环境中验证核心功能
2. 对于多模块项目，确保测试包含子模块的构建验证
3. 关注插件的发布说明，了解重大变更

总结

这个案例展示了即使是看似简单的API变更也可能带来意想不到的行为变化。在Java中，Properties类的默认值机制有其特殊性，开发者在类似场景下应当谨慎处理属性复制操作。git-commit-id-maven-plugin的维护团队快速响应并修复了这个问题，体现了开源社区的高效协作。

对于依赖此插件的项目，升级到9.0.1或更高版本即可解决这个问题，恢复正常的Git信息生成功能。