本文详解如何在 arraylist 存储的自定义对象中，安全、准确地实现对字段（如 organizationname）的忽略大小写部分匹配搜索，避免空指针异常和逻辑错误。
在使用 ArrayList<Address> 进行模糊搜索时，常见的需求是：根据用户输入的关键词（如 "anth"），查找所有 organizationName 字段中包含该关键词（不区分大小写） 的地址对象。但直接调用 String.contains() 会导致大小写敏感问题，而错误的 toLowerCase() 调用顺序还可能引发 NullPointerException。
? 核心问题分析
原始代码存在两个关键缺陷：
- 空指针风险：d.getOrganizationName().toLowerCase() != null 先调用了 toLowerCase()，若 getOrganizationName() 返回 null，会立即抛出 NullPointerException，根本无法进入判空逻辑；
- 大小写未统一：contains() 前未将 d.getOrganizationName() 转为小写，导致 "Anth".contains("anth") 返回 false（因为 contains 是严格字符匹配）。
✅ 正确实现方式
应先判空，再统一转小写后执行 contains：
@Override
public List<Address> searchAddress(String search) {
// 若 search 为空或空白，可选择返回空列表或全部数据（按业务需求）
if (search == null || search.trim().isEmpty()) {
return new ArrayList<>(list); // 返回副本，避免外部修改原列表
}
List<Address> result = new ArrayList<>();
String searchTerm = search.trim().toLowerCase(); // 预处理搜索词
for (Address address : list) {
String orgName = address.getOrganizationName();
// 安全判空 + 统一小写匹配
if (orgName != null && orgName.toLowerCase().contains(searchTerm)) {
result.add(address);
}
}
return result;
}? 进阶建议（提升健壮性与性能）
- 避免重复调用 toLowerCase()：若 organizationName 字段值固定且查询频繁，可考虑在 Address 类中增加一个 getOrganizationNameIgnoreCase() 方法，或在构造时缓存小写版本（权衡内存与 CPU）；
-
使用 Java 8+ Stream 提升可读性：
public List<Address> searchAddress(String search) { if (search == null || search.trim().isEmpty()) return new ArrayList<>(list); String term = search.trim().toLowerCase(); return list.stream() .filter(addr -> addr.getOrganizationName() != null && addr.getOrganizationName().toLowerCase().contains(term)) .collect(Collectors.toList()); } - 增强匹配能力（可选）：如需支持更灵活的搜索（如分词、前缀匹配、正则），可引入 Apache Commons Lang 的 StringUtils.containsIgnoreCase() 或集成 Lucene/Elasticsearch。
⚠️ 注意事项总结
- ✅ 始终先检查 getOrganizationName() != null，再调用任何字符串方法；
- ✅ search 参数也应判空/去空格，防止 " " 导致意外行为；
- ❌ 禁止在 null 对象上调用 toLowerCase()、contains() 等实例方法；
- ? String.toLowerCase() 在某些 Locale 下可能产生非预期结果（如土耳其语），如需国际化强一致性，建议显式指定 Locale.ENGLISH：
orgName.toLowerCase(Locale.ENGLISH).contains(searchTerm.toLowerCase(Locale.ENGLISH))
通过以上修正，searchAddress("Anth") 和 searchAddress("anth") 将均能正确匹配到 organizationName = "Anth" 的对象，真正实现大小写不敏感的子串搜索。
立即学习“Java免费学习笔记（深入）”；
