Grails应用升级至7.0.0-M3后配置文件加载问题解析

在将Grails应用升级到7.0.0-M3版本后，开发者可能会遇到一个典型的配置文件加载问题：应用无法正确读取YAML配置文件内容。本文将深入分析这一问题的成因及解决方案。

问题现象

升级后的应用在尝试读取配置文件时，虽然propertySources中确实包含了application.yml的内容，但通过PropertySourcesConfig解析后却返回了空列表。具体表现为：

1. 调试信息显示propertySources对象包含完整的YAML配置内容
2. 但解析后的结果集大小为0
3. 相同版本的新建应用却能正常读取配置

根本原因分析

经过深入排查，发现问题根源在于build.gradle文件中的bootRun配置项。具体来说，当配置中包含以下内容时会导致问题：

bootRun {
    systemProperty 'spring.profiles.active', 'dev'
}

这种显式设置Spring Profile的方式在Grails 7.0.0-M3中会干扰配置文件的正常加载机制。值得注意的是，这个问题不会出现在新建的Grails 7应用中，因为新建项目通常不会包含这类特定的bootRun配置。

解决方案

解决此问题的方法很简单：

1. 移除build.gradle中bootRun配置的spring.profiles.active系统属性设置
2. 或者改用Grails推荐的环境变量方式来设置Profile

修改后，配置文件的加载将恢复正常。这是因为Grails 7.0.0-M3改进了配置加载机制，对Profile的处理方式有所变化。

技术背景

理解这个问题的关键在于了解Grails 7的配置加载改进：

1. 配置加载现在更紧密地集成了Spring Boot的机制
2. Profile激活方式变得更加严格
3. 系统属性和环境变量的处理优先级发生了变化

在Grails 7中，推荐使用以下方式设置Profile：

• 通过application.yml中的spring.profiles.active设置
• 使用环境变量SPRING_PROFILES_ACTIVE
• 避免在bootRun中硬编码Profile设置

最佳实践建议

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

1. 升级时仔细检查所有与环境相关的配置
2. 优先使用YAML文件定义Profile
3. 在需要覆盖配置时使用环境变量而非系统属性
4. 全面测试各环境的配置加载情况

通过遵循这些实践，可以确保Grails应用在升级后能够正确加载所有配置信息。