使用CriteriaBuilder能否关联未被选中实体引用的表？

首先得明确你遇到的问题根源：你调用的vehicle.join("vs", JoinType.LEFT)是基于实体类中已定义的关联属性来创建连接的，但你的Vehicle实体并没有名为vs的关联属性指向VehicleStatus，所以才会抛出Unable to locate Attribute with the given name [vs] on this ManagedType异常。

针对你的需求，有两种可行的解决方案，取决于你是否愿意修改实体类：

方案1：临时添加实体关联（推荐，如果你能修改实体） #

如果允许调整Vehicle实体的映射关系，直接添加和VehicleStatus的关联即可，这样后续用CriteriaBuilder会更顺畅：

// 在Vehicle实体中添加关联
@OneToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "id", referencedColumnName = "vehicleId")
private VehicleStatus vehicleStatus;

之后你就可以直接通过属性名来创建连接：

Join<Vehicle, VehicleStatus> vs = vehicle.join("vehicleStatus", JoinType.LEFT);
// 不需要手动加on条件，JPA会自动根据映射处理

方案2：不修改实体，手动创建连接并指定ON条件 #

如果你不想改动实体类，也可以通过CriteriaBuilder的重载方法来实现原生SQL里的LEFT JOIN ... ON逻辑。关键是不要通过属性名来join，而是直接指定要连接的实体类型，再手动添加连接条件：

Root<Vehicle> vehicle = criteriaQuery.from(Vehicle.class);
// 直接指定要连接的实体类型和连接方式
Join<Vehicle, VehicleStatus> vs = vehicle.join(VehicleStatus.class, JoinType.LEFT);
// 手动添加ON条件，对应原生SQL里的关联逻辑
vs.on(cb.equal(vehicle.get("id"), vs.get("vehicleId")));

这种方式本质上是先创建一个交叉连接，再通过on()方法过滤出符合关联条件的记录，效果和你要的原生SQL完全一致。

另外，如果你觉得CriteriaBuilder的这种写法还是太麻烦，也可以直接使用原生SQL查询，比如：

String nativeSql = "select v.*, vs.* from Vehicle v left join VehicleStatus vs on v.id = vs.vehicleId ...";
Query query = entityManager.createNativeQuery(nativeSql, YourResultClass.class);
// 执行查询并处理结果

内容的提问来源于stack exchange，提问作者Sean