SpringBoot执行SQL时触发InvalidDataAccessResourceUsageException问题排查

问题场景 #

在Spring Boot项目中，通过JPA Repository执行原生SQL查询获取服务器角色：

@Query(nativeQuery = true, value = "SELECT role FROM sys.geo_replication_links")
public int getServerName();

该查询在SQL浏览器中可正常执行，但在项目中触发异常，核心错误为：

com.microsoft.sqlserver.jdbc.SQLServerException: Invalid object name 'sys.geo_replication_links'.

查询方法被添加在绑定业务实体的Repository中：

public interface ReadRepository extends CrudRepository<ReadEntity, String> 
{
    ReadEntity save(ReadEntity var1);
    @Query(nativeQuery = true, value = "SELECT role FROM sys.geo_replication_links")
    public int getServerName();
}

核心原因 #

1. 数据库连接上下文不匹配：Spring Boot配置的数据源连接的数据库/实例，与SQL浏览器使用的不一致；或者连接用户没有查询系统视图sys.geo_replication_links的权限。
2. 系统视图的数据库归属问题：如果是Azure SQL数据库，sys.geo_replication_links仅存在于master数据库中，若项目数据源连接的是业务数据库，直接查询会找不到对象。
3. 返回值类型不匹配：sys.geo_replication_links的role字段是字符串类型（如PRIMARY/SECONDARY），用int接收会引发后续类型转换错误，不过当前报错先触发对象不存在问题。
4. Repository实体绑定的潜在影响：绑定业务实体的Repository可能默认使用实体指定的schema，导致系统视图的sys schema被忽略或解析错误。

解决方案 #

1. 确认数据源与权限 #

检查项目配置文件（application.properties/application.yml）中的spring.datasource.url，确保与SQL浏览器连接的是同一个数据库实例和数据库名；同时验证数据库用户具备查询sys.geo_replication_links的权限。

2. 明确指定系统数据库（针对Azure SQL等场景） #

如果是Azure SQL，需指定master数据库进行查询：

@Query(nativeQuery = true, value = "SELECT role FROM master.sys.geo_replication_links")
public String getServerRole();

3. 修正返回值类型 #

将方法返回值从int改为String，匹配role字段的实际类型：

@Query(nativeQuery = true, value = "SELECT role FROM sys.geo_replication_links")
public String getServerRole();

4. 分离系统查询与业务Repository #

避免将系统表查询与业务实体Repository混合，创建独立的无实体绑定Repository：

public interface SystemRepository extends Repository<Object, Void> {
    @Query(nativeQuery = true, value = "SELECT role FROM sys.geo_replication_links")
    String getServerRole();
}

验证方法 #

先执行简单系统查询验证连接与权限，比如：

@Query(nativeQuery = true, value = "SELECT name FROM sys.databases")
List<String> getDatabaseNames();

若能正常返回结果，说明连接与权限无问题，再排查视图归属与返回值问题。

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