从Properties文件构建Java List失败：无法添加额外门店至列表

开发者阿泽

2026-5-19

排查额外门店未添加的常见遗漏点

我来帮你梳理下可能没做到的几个关键环节，毕竟我也踩过类似的坑😉：

Properties文件读取环节出错
你有没有确认文件路径是否正确？比如放在resources目录下的文件，得用getClass().getResourceAsStream("/extraStores.properties")来读取，路径错了根本拿不到数据。另外，有没有处理IOException？如果读取时抛出异常却被悄悄吞了，那自然读不到额外门店的配置。
未将Properties字符串转换为Store对象
Properties里存的是键值对字符串，比如store1.number=001、store1.abbr=BJ这种格式，你得手动把这些字符串映射成Store实例。要是直接把Properties里的原始字符串往列表里塞，不仅类型不匹配，Stream合并时也不会识别成有效门店。
忽略了列表的可变性
从getStore(..)返回的列表如果是不可变列表（比如用Collections.unmodifiableList()包装过，或是JPA查询返回的只读列表），直接调用add()/addAll()会抛出UnsupportedOperationException。这时候得先把它转成可变列表，比如new ArrayList<>(dbStores)，再添加额外门店。
Stream合并时没做收集操作
Stream是惰性求值的，如果你只写了dbStores.stream().concat(extraStores.stream())却没调用collect(Collectors.toList())，那根本不会生成合并后的新列表，原列表自然没变化。
额外门店数据为空或解析逻辑错误
有没有打日志确认Properties里确实有数据？比如读取后输出properties.size()看看是不是0。要是文件是空的，或者你的解析逻辑和配置格式不匹配（比如漏读了某个字段），那转换出来的Store对象可能为空，自然没法添加到列表里。

给你一个简单的正确流程示例，对照着检查自己的代码：

// 1. 获取数据库门店并转为可变列表
List<Store> completeStores = new ArrayList<>(getStore(...));

// 2. 读取Properties文件
Properties props = new Properties();
try (InputStream is = getClass().getResourceAsStream("/extraStores.properties")) {
    props.load(is);
} catch (IOException e) {
    // 别吞异常！这里一定要打日志
    log.error("加载额外门店配置失败", e);
    return completeStores;
}

// 3. 解析配置为Store对象（假设格式是store_<序号>_<字段>）
List<Store> extraStores = new ArrayList<>();
int index = 1;
while (true) {
    String number = props.getProperty("store_" + index + "_number");
    if (number == null) break;
    String abbr = props.getProperty("store_" + index + "_abbr");
    String name = props.getProperty("store_" + index + "_name");
    extraStores.add(new Store(number, abbr, name));
    index++;
}

// 4. 合并列表（二选一即可）
// 方式一：直接添加
completeStores.addAll(extraStores);
// 方式二：用Stream收集
completeStores = Stream.concat(completeStores.stream(), extraStores.stream())
                       .collect(Collectors.toList());

你可以对照上面的步骤逐一排查，大概率是读取、解析或者列表可变性的问题~

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