SpringBoot 内置 CollectionUtil：实战用法速览，告别空指针！

📌 核心实用功能

CollectionUtil 是 SpringBoot 中超实用的集合工具类（spring-core 包自带），不用额外引入依赖，就能轻松搞定集合判空、转换、筛选等高频场景，今天就用🌰带你吃透这些实用功能！

✅判空：isEmpty/isNotEmpty（最常用）

✅转换：arrayToList（数组转集合）

✅合并：mergeArrayIntoCollection（集合 + 数组合并）

✅匹配：contains（元素存在判断）

✅兜底：emptyIfNull（避免 Null 返回）

📌 实战例子

1. 集合判空（最常用❗️）

痛点：手动写list == null || list.isEmpty()又繁琐又容易漏解决方案：CollectionUtil.isEmpty()/CollectionUtil.isNotEmpty()

import org.springframework.util.CollectionUtils; import java.util.List; // 模拟业务场景：查询用户订单列表 List<String> orderIds = userService.getOrderIds(1001); // 判空：空集合/Null都返回true if (CollectionUtils.isEmpty(orderIds)) { System.out.println("❌ 暂无订单数据"); return; } // 非空才处理 if (CollectionUtils.isNotEmpty(orderIds)) { System.out.println("✅ 订单数：" + orderIds.size()); }

2. 数组转集合（快速转换💨）

痛点：数组转 List 还要手动 new ArrayList + 遍历，太麻烦解决方案：CollectionUtils.arrayToList()

import org.springframework.util.CollectionUtils; // 模拟：接口返回数组格式的商品ID String[] goodsIds = {"1001", "1002", "1003"}; // 一行转成List List<String> goodsList = CollectionUtils.arrayToList(goodsIds); System.out.println("📦 转换后的集合：" + goodsList); // [1001, 1002, 1003]

3. 集合合并（拼接两个集合🧩）

痛点：合并两个 List 要循环 addAll，代码冗余解决方案：CollectionUtils.mergeArrayIntoCollection()

import org.springframework.util.CollectionUtils; import java.util.ArrayList; import java.util.List; // 模拟：购物车合并（本地购物车 + 线上购物车） List<String> localCart = new ArrayList<>(); localCart.add("商品A"); localCart.add("商品B"); String[] onlineCart = {"商品C", "商品D"}; // 把数组合并到集合中 CollectionUtils.mergeArrayIntoCollection(onlineCart, localCart); System.out.println("🛒 合并后购物车：" + localCart); // [商品A, 商品B, 商品C, 商品D]

4. 判读集合是否包含指定元素（精准匹配🎯）

痛点：手动遍历判断元素是否存在，代码不优雅解决方案：CollectionUtils.contains()

import org.springframework.util.CollectionUtils; import java.util.List; // 模拟：判断用户是否在白名单内 List<String> whiteList = List.of("admin", "test", "user1"); String currentUser = "admin"; if (CollectionUtils.contains(whiteList.iterator(), currentUser)) { System.out.println("✅ 用户在白名单，允许操作"); } else { System.out.println("❌ 无权限，请联系管理员"); }

5. 空集合兜底（避免返回 Null🚫）

痛点：方法返回 Null 集合，调用方容易空指针解决方案：CollectionUtils.emptyIfNull()

import org.springframework.util.CollectionUtils; import java.util.List; // 模拟：查询用户收藏列表（可能返回Null） List<String> collectList = collectService.getCollects(1001); // 兜底：如果是Null，返回空集合（而非Null） List<String> safeList = CollectionUtils.emptyIfNull(collectList); // 放心遍历，不会空指针 safeList.forEach(collect -> System.out.println("⭐ 收藏内容：" + collect));