SpringBoot多模块JAR部署中application.properties配置规范及问题咨询

你遇到的错误核心原因是：Spring Boot默认仅会自动加载**主应用模块（application模块）**的application.properties/application.yml文件，依赖模块（library模块）中的同名配置文件不会被自动加载，导致@Value无法解析占位符。

问题1：多模块项目中是否不能在每个模块保留application.properties，只能用@ConfigurationProperties？ #

• 不是。你可以在各模块放置配置文件，但不要使用application.properties/application.yml作为依赖模块的配置文件名——因为Spring Boot的自动配置逻辑优先加载主模块的同名文件，依赖模块的会被直接忽略。
• @ConfigurationProperties是推荐的类型安全属性绑定方式，但不是唯一选择，它的优势在于批量属性管理、自动补全，和是否使用模块级配置文件没有强制绑定关系。

问题2：通过模块级properties+@Value传递多属性的方式是否不被允许？ #

• 这种方式本身是允许的，但需要确保Spring能正确加载依赖模块的配置文件。你之前出错是因为依赖模块的application.properties未被加载，而非@Value的用法错误。
• 注意：@Value适合零散属性的注入，若需要向多个类传递大量属性，@ConfigurationProperties的类型安全绑定会更易维护。

问题3：application.properties是否仅允许放在主模块？ #

• 不是。但依赖模块中的application.properties不会被Spring Boot自动加载，因为Spring Boot的自动配置上下文默认只扫描主模块的application.properties。
• 如果一定要在依赖模块用这个文件名，需要手动通过@PropertySource指定加载，但不推荐——容易和主模块的配置冲突，也不利于配置集中管理。

问题4：Spring Boot多模块项目管理properties的标准方式 #

这里提供两种最常用的标准方案：

方案1：依赖模块使用自定义配置文件+@PropertySource #

1. 在library模块的src/main/resources下创建自定义配置文件，比如library.properties：

service.message.test=Hello from Library Module

2. 在library模块中创建一个配置类，加载该文件：

@Configuration
@PropertySource("classpath:library.properties")
public class LibraryConfiguration {
}

3. 之后library模块中的@Value("${service.message.test}")就能正常解析属性了。

方案2：主模块集中管理所有配置（推荐） #

将所有模块的属性统一放在主应用模块的application.properties中，依赖模块直接通过@Value或@ConfigurationProperties引用：

1. 主模块application.properties添加：

# 主应用属性
service.message=Hello, World
# library模块所需属性
service.message.test=Hello from Library Module

2. library模块的代码无需修改配置文件，直接使用@Value或@ConfigurationProperties即可——Spring Boot会自动加载主模块的配置，依赖模块能共享这些属性。
3. 若使用@ConfigurationProperties，可以在library模块定义属性类：

@ConfigurationProperties(prefix = "service")
public class ServiceProperties {
    private String message;
    private String messageTest; // 对应service.message.test

    // getter、setter方法
}

然后在主模块或library模块的配置类上添加@EnableConfigurationProperties(ServiceProperties.class)，就能注入使用。

额外注意点 #

• 不要在多个模块中使用同名的application.properties，避免配置覆盖或加载异常。
• @EnableConfigurationProperties通常放在配置类（而非Service类）上，更符合Spring的配置规范。

内容的提问来源于stack exchange，提问作者ashish chauhan