运费 = 首重价格 + (计费重量 - 1) × 续重单价

同城      → 最便宜（一个城市内，送货成本低）
省内      → 便宜
经济区互寄 → 中等（京津冀、江浙沪、川渝、黑吉辽）
跨省      → 最贵

// chain-cloud-ms-carriage-service CarriageServiceImpl#findCarriageTemplate
private CarriageEntity findCarriageTemplate(WaybillDTO waybillDTO) {

    // L1 判断是否为同城
    if (ObjectUtil.equal(waybillDTO.getSenderCityId(), waybillDTO.getReceiverCityId())) {
        CarriageEntity t = this.findByTemplateType(CarriageConstant.SAME_CITY);
        if (ObjectUtil.isNotEmpty(t)) return t;      // 命中就返回
    }

    // L2 判断是否为省内（要 Feign 查 base 服务拿 city 的 parentId）
    var sendParentId = areaFeign.get(waybillDTO.getSenderCityId()).getParentId();
    var receiveParentId = areaFeign.get(waybillDTO.getReceiverCityId()).getParentId();
    if (ObjectUtil.equal(sendParentId, receiveParentId)) {
        CarriageEntity t = this.findByTemplateType(CarriageConstant.SAME_PROVINCE);
        if (ObjectUtil.isNotEmpty(t)) return t;
    }

    // L3 判断是否为经济区互寄
    LinkedHashMap<String, EconomicRegionEnum> enumMap = EnumUtil.getEnumMap(EconomicRegionEnum.class);
    String jjqCode = null;
    for (var value : enumMap.values()) {
        // 判断两个省是否都在同一个经济区里
        boolean b = ArrayUtil.containsAll(value.getValue(), sendParentId, receiveParentId);
        if (b) { jjqCode = value.getCode(); break; }
    }
    if (ObjectUtil.isNotEmpty(jjqCode)) {
        LambdaQueryWrapper<CarriageEntity> qw = Wrappers.<CarriageEntity>lambdaQuery()
                .eq(CarriageEntity::getTemplateType, CarriageConstant.ECONOMIC_ZONE)
                .eq(CarriageEntity::getTransportType, CarriageConstant.REGULAR_FAST)
                .apply("FIND_IN_SET({0}, associated_city)", jjqCode);
        CarriageEntity one = this.getOne(qw);
        if (ObjectUtil.isNotEmpty(one)) return one;
    }

    // L4 兜底
    return this.findByTemplateType(CarriageConstant.TRANS_PROVINCE);
}

// CarriageServiceImpl#computeWeight
private double computeWeight(WaybillDTO waybillDTO, CarriageEntity carriageTemplate) {

    Integer volume = null;
    // 体积：传入体积和 长×宽×高(cm) 取最大
    try {
        Integer weight = waybillDTO.getMeasureLong()
                        * waybillDTO.getMeasureWidth()
                        * waybillDTO.getMeasureHigh();
        volume = Math.max(waybillDTO.getVolume(), weight);
    } catch (Exception e) {
        volume = 0;
    }

    // 体积重 = 体积 / 轻抛系数（Hutool div 默认 HALF_UP 保留 1 位）
    var actualWeight = NumberUtil.div(volume, carriageTemplate.getLightThrowingCoefficient(), 1);

    // 计费重量 = max(体积重, 实际重量)
    double computeWeight = Math.max(actualWeight.doubleValue(), waybillDTO.getWeight());

    if (computeWeight <= 1)   return 1;                                    // 阶梯一
    if (computeWeight <= 10)  return NumberUtil.round(computeWeight, 1).doubleValue(); // 阶梯二
    if (computeWeight >= 100) return NumberUtil.round(computeWeight, 0).doubleValue(); // 阶梯四

    // 阶梯三：10~100kg，向上取到 0.5 的整数倍
    var integer = NumberUtil.round(computeWeight, 0, RoundingMode.DOWN).intValue();
    if (NumberUtil.sub(computeWeight, integer) == 0) return integer;
    if (NumberUtil.sub(computeWeight, integer) <= 0.5) return NumberUtil.add(integer, 0.5);
    return NumberUtil.add(integer, 1);
}

// CarriageServiceImpl#findByTemplateType
@Override
public CarriageEntity findByTemplateType(Integer templateType) {
    if (ObjectUtil.equals(templateType, CarriageConstant.ECONOMIC_ZONE)) {
        // 方法调用错误：经济区互寄不通过该方法查询模板
        throw new CCException(CarriageExceptionEnum.METHOD_CALL_ERROR);
    }
    ...
}

SELECT * FROM cc_carriage
WHERE template_type = 3 AND transport_type = 1
  AND FIND_IN_SET('2', associated_city)   -- '2' = 京津冀

// CarriageServiceImpl#saveOrUpdate（经济区分支）
List<String> associatedCityList = StreamUtil.of(list)
        .filter(e -> ObjectUtil.notEqual(e.getId(), carriageDto.getId())) // 排除自己
        .map(CarriageEntity::getAssociatedCity)
        .map(a -> StrUtil.split(a, ','))      // "2,3" -> ["2","3"]
        .flatMap(StreamUtil::of)              // 展开
        .collect(Collectors.toList());

Collection<String> intersection =
        CollUtil.intersection(associatedCityList, carriageDto.getAssociatedCityList());
if (CollUtil.isNotEmpty(intersection)) {
    throw new CCException(CarriageExceptionEnum.ECONOMIC_ZONE_CITY_REPEAT);
}

// 应该长成这样
assertEquals(18.5, computeWeight(waybill(18.1)));
assertEquals(19.0, computeWeight(waybill(18.8)));
assertEquals(109,  computeWeight(waybill(108.5)));

// 缓存 key 的设计（这是难点，不是写 @Cacheable 本身）
String key = "carriage:template:"
         + sameCityFlag + ":"            // 是否同城
         + sendProvinceId + ":"           // 寄件省
         + receiveProvinceId;             // 收件省
// 失效：用"模板配置版本号"做 key 后缀，改配置时 +1
// 这样一个 key 下挂着所有命中该模板的地址组合

private Double firstWeight;        // 首重价格
private Double continuousWeight;   // 续重单价
...
double expense = carriageTemplate.getFirstWeight()
              + ((weight - 1) * carriageTemplate.getContinuousWeight());
expense = NumberUtil.round(expense, 1).doubleValue();

0.1 + 0.2 = 0.30000000000000004   （二进制浮点无法精确表示十进制小数）

BigDecimal weight = BigDecimal.valueOf(computeWeight);      // 注意用 valueOf，不要 new BigDecimal(double)
BigDecimal amount = carriage.getFirstWeight()
        .add(weight.subtract(BigDecimal.ONE)
                  .multiply(carriage.getContinuousWeight()));
carriage.setExpense(amount.setScale(2, RoundingMode.HALF_UP));

// CarriageExceptionEnum
NOT_FOUND(1003, "寄/收地址所属区域暂无计价规则，无法下单"),

四级都没匹配到
  → findByTemplateType 返回 null（MyBatis-Plus getOne 查 0 行返回 null，不抛异常）
  → findCarriageTemplate 返回 null，代码里没有任何判空
  → compute() 第 129 行 carriageTemplate.getFirstWeight() → NullPointerException
  → GlobalExceptionHandler 的兜底 handler 捕获
  → HTTP 500，响应体里带完整堆栈

// L4 兜底
CarriageEntity template = this.findByTemplateType(CarriageConstant.TRANS_PROVINCE);
if (ObjectUtil.isEmpty(template)) {
    throw new CCException(CarriageExceptionEnum.NOT_FOUND);
}
return template;

.eq(CarriageEntity::getTransportType, CarriageConstant.REGULAR_FAST)