Spring Webflux中使用R2DBC操作SQL Server时如何转义保留字？

针对你遇到的SQL Server保留字key作为列名导致的语法错误，以下是经过验证的解决方案：

核心问题分析 #

你尝试的方括号[key]是SQL Server官方认可的保留字转义方式，之所以失效，大概率是两个细节问题：

• 查询中参数名与列名同名（:key和[key]），导致Spring Data R2DBC的查询解析逻辑出现混淆
• 原查询中: id存在多余空格，属于语法错误

具体解决方案 #

1. 修改参数名避免冲突
   将参数名改为与列名不同的名称，比如inputKey，同时用@Param注解明确绑定：

@Query("SELECT * FROM my_table WHERE [key] = :inputKey AND id = :id")
Flux<MyEntity> findByKeyAndId(@Param("inputKey") String key, @Param("id") Long id);

2. 确保实体类映射正确
   如果你的实体类对应my_table，需要在字段上用@Column注解明确指定转义后的列名，避免映射时出错：

public class MyEntity {
    @Id
    private Long id;
    
    @Column(name = "[key]")
    private String key;
    
    // 其他字段和 getter/setter
}

3. 验证QUOTED_IDENTIFIER配置
   SQL Server默认开启QUOTED_IDENTIFIER设置，此时双引号也可以用来转义保留字，但如果你的连接配置中关闭了这个选项，双引号会被当作字符串处理。可以在连接URL中强制开启：

r2dbc:mssql://localhost:1433/mydatabase?quotedIdentifier=true

不过更推荐始终使用方括号，因为它不受该配置影响，兼容性更强。

额外注意事项 #

• 不要使用反引号`，这是MySQL的转义方式，SQL Server不支持
• 检查R2DBC SQL Server驱动版本，确保使用最新稳定版（比如io.r2dbc:r2dbc-mssql:1.0.2及以上），旧版本可能存在查询解析的bug

内容的提问来源于stack exchange，提问作者Laura Páramo