在 MyBatis 中，若数据库字段名与 SQL 保留字冲突解决办法

在 MyBatis 中，若数据库字段名与 SQL 保留字冲突，可通过以下方法解决：

一、使用转义符号包裹字段名

通过添加数据库特定的转义符号（如反引号 ` 或方括号 []）直接标识保留字字段。例如：

• MySQL：用反引号包裹字段名，如 `order`；
• SQL Server：用方括号包裹，如 [order]；
• 在 XML 映射文件中编写 SQL 时，语法示例：

  <select id="selectByOrder" resultType="Order">
      SELECT `order`, user_id FROM orders WHERE id = #{id}
  </select>
  

二、通过别名映射

在 SQL 查询中为保留字字段赋予别名，并在结果集映射（resultMap）中关联别名与实体类属性。例如：

• 查询语句中定义别名：

  <select id="findAllUser" resultMap="userMap">
      SELECT u.id AS user_id, a.`order` AS account_order 
      FROM user u LEFT JOIN account a ON u.id = a.uid
  </select>
  

• 在 resultMap 中配置别名与属性的对应关系：

  <resultMap id="userMap" type="User">
      <result column="user_id" property="id"/>
      <collection property="accounts" ofType="Account">
          <result column="account_order" property="order"/>
      </collection>
  </resultMap>
  

  此方法在关联查询中尤其适用，可同时解决多表字段冲突问题。

三、借助 MyBatis-Plus 注解

若使用 MyBatis-Plus，可通过 @TableField 注解直接指定转义后的字段名：

public class Order {
    @TableField(value = "`order`")
    private String order;
}

此方式简化了 XML 配置，适用于字段级精准控制。

四、全局配置策略（辅助方案）

通过 MyBatis 配置开启驼峰命名转换，将数据库字段的 order_status 自动映射为实体类的 orderStatus 属性，但需注意：

• 配置示例：

  <settings>
      <setting name="mapUnderscoreToCamelCase" value="true"/>
  </settings>
  

• 局限性：仅适用于字段名与属性名的格式差异（如下划线转驼峰），无法直接解决保留字冲突。

最佳实践与注意事项

1. 优先规避保留字：在数据库设计阶段，尽量避免使用保留字作为字段名，例如改用 order_no 代替 order。
2. 数据库兼容性：不同数据库的转义符号可能不同，需根据实际数据库类型调整（如 PostgreSQL 使用双引号 "order"）。
3. 代码可读性：若必须使用保留字，建议在实体类和 SQL 中通过注释明确说明，便于后续维护。

通过以上方法，可灵活应对字段名与保留字冲突的场景。具体选择需结合项目架构（是否使用 MyBatis-Plus）和数据库类型。