Collectors.averagingDouble可一行计算流中数值平均值,需确保映射函数返回double且流非空;支持基础数字列表、对象属性及分组平均,但空流返回0.0,灵活性不足时应选summarizingDouble等替代方案。

直接用 Collectors.averagingDouble 可以一行代码算出流中数值的平均值,关键是要确保映射函数返回 double 类型,且流非空——否则会得到 OptionalDouble.empty() 或抛出异常。
基础用法:从简单数字列表求平均
最常见场景是对 List<double></double> 或 List<integer></integer> 求平均。注意:即使源是整数,映射时也要转成 double,否则精度丢失或编译报错。
-
✅ 正确写法(自动装箱+类型适配):
double avg = numbers.stream().collect(Collectors.averagingDouble(Double::doubleValue)); -
✅ 整数列表也适用(隐式转换):
double avg = Arrays.asList(1, 2, 3, 4).stream().collect(Collectors.averagingDouble(i -> (double) i)); -
❌ 错误写法(返回 int,不匹配签名):
Collectors.averagingDouble(i -> i * 2)—— 若i是int,该 lambda 返回int,编译失败。
对象属性求平均:避免 null 和空集合陷阱
处理实体类(如 Product)的价格均值时,需提前过滤 null 属性,并考虑空流情况。
- 先用
filter排除 price 为 null 的对象:products.stream().filter(p -> p.getPrice() != null) - 再映射价格并计算:
.collect(Collectors.averagingDouble(Product::getPrice)) - 结果是
double,但若流为空,averagingDouble返回0.0(不是NaN或异常),这点和Collectors.summarizingDouble一致,但要注意业务是否允许空流默认为 0。
结合 groupingBy 做分组平均
比如按类别统计商品平均价格,用 Collectors.groupingBy 嵌套 averagingDouble 即可。
- 示例:
Map<String, Double> avgPriceByCategory = products.stream()<br> .collect(Collectors.groupingBy(<br> Product::getCategory,<br> Collectors.averagingDouble(Product::getPrice)<br> ));
- 结果中每个 category 对应一个
double平均值;若某分类下无有效 price,该分类结果为0.0。 - 如需排除空值影响更严格,可在映射前加 filter:
Collectors.groupingBy(Product::getCategory, Collectors.filtering(p -> p.getPrice() != null, Collectors.averagingDouble(Product::getPrice)))
替代方案对比:什么时候不该用 averagingDouble
它简洁,但不够灵活。以下情况建议换方式:
- 需要同时获取平均值、计数、最大最小值 → 改用
Collectors.summarizingDouble,返回DoubleSummaryStatistics; - 要对空流抛异常或返回 Optional → 手动 collect 到
List后判断 size 再计算; - 数据量极大且只关心平均值 → 用
StreamSupport+ 自定义DoubleAccumulator避免装箱开销(进阶优化)。

















