Spring Boot读取properties中List配置推荐逗号分隔写法，如app.features=login,logout；Map需用方括号指定key，如app.roles[admin]=read；绑定需@ConfigurationProperties+setter+Spring管理。
Spring Boot 读取 properties 文件中的数组（严格说是 List）配置，核心在于写法规范 + 正确注解绑定。它不支持原生数组语法（如 arr[0]=a,arr[1]=b 直接映射为数组），但能自然映射为 List<string></string> 或 String[]，关键看配置格式和 Java 类字段声明。
properties 中 List 的两种主流写法
推荐使用逗号分隔形式，简洁、健壮、兼容性好；方括号索引方式虽可用，但易出错且不推荐用于生产环境。
-
✅ 推荐写法（逗号分隔）：
在application.properties中写：app.features=login,logout,profile,notification
对应 Java 字段：private List<String> features;或private String[] features; -
⚠️ 可用但不推荐（索引式）：
app.features[0]=loginapp.features[1]=logoutapp.features[2]=profile
这种方式要求索引连续、不能跳号，且 Spring 不保证顺序稳定，调试困难。
Map 类型配置的正确写法
Map 必须用方括号指定 key，且 key 不能含点号（.）或特殊字符，否则解析失败。
-
✅ 正确示例：
app.roles[admin]=read,write,deleteapp.roles[user]=read
对应字段：private Map<String, String> roles;
结果：{"admin": "read,write,delete", "user": "read"} -
❌ 常见错误：
app.roles.admin=read,write→ 这会被当成普通字符串属性，不是 Map 元素；app.roles[super-admin]=full→ key 含连字符可能触发解析异常，建议用下划线或纯字母。
Java 类中如何绑定并生效
必须满足三个条件：类加 @ConfigurationProperties、有 setter 方法（或 Lombok @Data）、类被 Spring 管理（加 @Configuration 或 @Component）。
- 定义配置类：
@ConfigurationProperties(prefix = "app")
@Configuration
public class AppProperties {
private List<String> features;
private Map<String, String> roles;
// 必须提供 public setter 方法
public void setFeatures(List<String> features) { this.features = features; }
public void setRoles(Map<String, String> roles) { this.roles = roles; }
} - 启用配置绑定（Spring Boot 2.2+ 默认开启，老版本需加
@EnableConfigurationProperties）；
确保该类被 Spring 扫描到（放在主启动类同包或子包下，或显式@Import）。
替代方案：@Value 也能读 List，但有限制
@Value 可读逗号分隔字符串并转成 List，但无法直接注入 Map，也不支持嵌套结构。
- 写法示例：
@Value("${app.features:}") private List<String> features;
注意：Spring 会自动按逗号切分并 trim 空格，但前提是字段类型为List<String>且容器中有ConversionService（默认存在）。 - 缺点：无法校验、无类型安全、不支持复杂嵌套、无法设默认空集合（
:[]不生效），仅适合简单场景。
