使用Hibernate原生查询时出现「无效对象名」问题排查

问题背景 #

使用JPA的@Query执行带锁的原生SQL查询时，出现Invalid object name 'EVENTS_TABLE'错误，数据库中确实存在该表，且已配置默认schema，但仅指定完整数据库路径（database.schema.EVENTS_TABLE）时查询正常。相同代码在Azure免费SQL Server上可正常运行，需排查配置或数据库层面的问题。

查询代码如下：

@Query(value = "SELECT TOP (?1) stg.*, a.alias " +
        "FROM EVENTS_TABLE e WITH (UPDLOCK, ROWLOCK, READPAST) " +
        "INNER JOIN areas a ON e.zone_code = a.zone_id " +
        "WHERE e.company_id = ?2 AND e.processed = ?3 ", nativeQuery = true)
List<Event> getEventsToProcess(Integer batchSize,
                                  String companyCode,
                                  Boolean processed);

可能的原因及解决办法 #

1. JDBC URL未指定默认schema #

JPA的默认schema配置（如spring.jpa.properties.hibernate.default_schema）仅对JPQL生效，原生SQL查询会直接发送给数据库，不会自动应用该配置。SQL Server JDBC驱动需要在URL中显式指定currentSchema，才能让原生查询默认使用目标schema。

解决：
修改application.properties中的JDBC URL，添加currentSchema参数：

spring.datasource.url=jdbc:sqlserver://your-server-address:1433;databaseName=your-db-name;currentSchema=your-target-schema;

2. 数据库用户默认schema不匹配 #

当前环境的数据库用户默认schema可能与Azure免费SQL上的不一致，导致原生查询使用用户默认schema查找表，而非你创建EVENTS_TABLE的schema。

解决：

• 查看当前用户的默认schema：

SELECT name, default_schema_name FROM sys.database_principals WHERE name = 'your-db-user';

• 修改用户默认schema为目标schema：

ALTER USER your-db-user WITH DEFAULT_SCHEMA = your-target-schema;

3. 数据库Collation大小写敏感问题 #

若当前环境数据库的Collation是大小写敏感的，而Azure免费SQL使用大小写不敏感的Collation，查询中表名大小写与实际表名不符时会导致找不到表。

解决：

• 查看数据库Collation：

SELECT name, collation_name FROM sys.databases WHERE name = 'your-db-name';

• 要么将查询中的表名修改为与实际表名完全一致，要么调整数据库Collation（需评估对现有数据的影响）。

4. 动态注入schema避免硬编码 #

若不想修改JDBC URL或用户默认schema，可通过SpEL表达式在原生查询中动态注入配置的schema，避免硬写全路径：

@Query(value = "SELECT TOP (?1) stg.*, a.alias " +
        "FROM ${spring.jpa.properties.hibernate.default_schema}.EVENTS_TABLE e WITH (UPDLOCK, ROWLOCK, READPAST) " +
        "INNER JOIN ${spring.jpa.properties.hibernate.default_schema}.areas a ON e.zone_code = a.zone_id " +
        "WHERE e.company_id = ?2 AND e.processed = ?3 ", nativeQuery = true)
List<Event> getEventsToProcess(Integer batchSize, String companyCode, Boolean processed);

确保application.properties中已正确配置spring.jpa.properties.hibernate.default_schema，且使用的Spring Boot版本支持SpEL在@Query中替换变量。

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