PropertyReferenceException异常排查：AssetVehicle无asset属性

错误日志 #

2024-10-19T11:26:28.546+05:30  WARN 9455 --- [rentsysapi] [nio-8080-exec-2] .m.m.a.ExceptionHandlerExceptionResolver : Resolved [org.springframework.data.mapping.PropertyReferenceException: No property 'asset' found for type 'AssetVehicle']

问题分析 #

这个错误是Spring Data JPA在解析属性路径时，找不到AssetVehicle实体中名为asset的属性。结合你从单表资产结构拆分为多表的背景，大概率是重构后旧代码的属性引用未同步更新，重点排查以下方向：

1. 检查AssetVehicleSpecification的实现 #

你在服务类中使用了AssetVehicleSpecification.hasStatus()、hasCompany()、hasOwner()方法，这些方法内部很可能保留了单表时代的属性路径（比如root.get("asset.status")），但现在AssetVehicle实体本身就有status、company等属性，不需要通过asset前缀访问。

错误示例：

public static Specification<AssetVehicle> hasStatus(AssetStatus status) {
    return (root, query, cb) -> {
        if (status == null) return cb.conjunction();
        // 错误：AssetVehicle中无asset属性，直接访问status即可
        return cb.equal(root.get("asset").get("status"), status);
    };
}

正确写法：

public static Specification<AssetVehicle> hasStatus(AssetStatus status) {
    return (root, query, cb) -> {
        if (status == null) return cb.conjunction();
        return cb.equal(root.get("status"), status);
    };
}

2. 排查所有自定义查询逻辑 #

• 检查Repository接口方法名是否拼写错误（比如误写findByAssetXxx）；
• 检查硬编码的JPQL/HQL语句，确认没有asset.xxx这类错误路径；
• 检查Criteria查询中的属性引用，确保层级正确。

3. 检查ModelMapper映射配置 #

如果自定义了AssetVehicle到AssetVehicleDto的映射规则，确认规则中没有引用不存在的asset属性。

快速验证步骤 #

1. 定位触发错误的请求，对应服务类中的具体方法；
2. 查看该方法依赖的Specification或查询逻辑，找出所有包含asset的属性引用；
3. 将错误引用替换为AssetVehicle实体实际存在的属性名（如status、company、owner等）。

内容的提问来源于stack exchange，提问作者Pasan Randula Eramusugoda