添加JPQL查询后代码编译失败，JPA报Unexpected AST node:=错误

我来帮你排查并修复这个JPQL的问题，你的代码里有几个明显的语法和逻辑错误，直接导致了编译失败：

问题分析 #

1. 逻辑或运算符使用错误：JPQL中不支持用||表示逻辑或，必须使用标准关键字OR——这是触发Unexpected AST node:=错误的核心原因，JPA解析器无法识别||，会把它当成非法的语法节点。
2. 关联实体未定义别名：你用了JOIN d.car但没给关联的Car实体起别名，后面却用c.licensePlate引用它的属性，JPA找不到c这个别名，自然会报关联子句错误。
3. 重复的查询条件：代码里重复写了两次(d.onlineStatus = :onlineStatus || :onlineStatus is null)，属于冗余代码，完全可以去掉重复项。
4. 未完成的条件拼写：最后一行的:licen...应该是:licensePlate的拼写截断，需要补全完整才能正常解析。

修正后的代码 #

public interface DriverRepository extends CrudRepository<DriverDO, Long> {
    @Query("SELECT d FROM DriverDO d JOIN d.car c " +
           "WHERE (d.username = :username OR :username is null) " +
           "AND (d.onlineStatus = :onlineStatus OR :onlineStatus is null) " +
           "AND (c.licensePlate = :licensePlate OR :licensePlate is null)")
    List<DriverDO> findByConditions(@Param("username") String username,
                                    @Param("onlineStatus") Integer onlineStatus,
                                    @Param("licensePlate") String licensePlate);
}

额外提示 #

• 如果DriverDO和Car的关联是可选的（即部分司机可能没有绑定车辆），可以把JOIN改成LEFT JOIN，这样即使没有关联车辆的司机也能被查询出来。
• 请确认DriverDO类中确实存在名为car的关联属性，且关联的Car实体类有licensePlate字段，否则依然会出现映射错误。

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