MyBatis OGNL 表达式避坑指南

MyBatis 中 OGNL 表达式的那些 "坑"：从字符串比较案例说起

在 MyBatis 开发中，<if>标签的test属性是实现动态 SQL 的核心，但很多开发者会遇到 "明明变量值符合预期，条件却不生效" 的问题。这背后往往是OGNL（Object-Graph Navigation Language）表达式的解析规则在 "作祟"。本文将通过两个真实案例，拆解 OGNL 对字符串、字符、数字的处理逻辑，帮你彻底避开这类陷阱。

一、先看两个 "反直觉" 的案例

在分析原理前，我们先明确核心变量背景：startInstLdgrHierCd是字符串类型，只是不同场景下值不同，却导致了完全不同的条件判断结果。

案例 1：变量值为 "0" 时的差异

当startInstLdgrHierCd = "0"（字符串 "0"）时，三种写法结果天差地别：

写法	是否成立	疑问
`<if test="startInstLdgrHierCd == '0'">`	❌ 不成立	明明值都是 "0"，为什么不生效？
`<if test="startInstLdgrHierCd == 0">`	✅ 成立	字符串和数字怎么能相等？
`<if test='startInstLdgrHierCd == "0"'>`	✅ 成立	换了引号包裹，为什么又生效了？

案例 2：变量值为 "01" 时的反转

当startInstLdgrHierCd = "01"（字符串 "01"）时，之前不生效的写法突然有效了：

xml 复制代码

<!-- 此时条件成立，与案例1中"0"的情况完全相反 -->
<if test="startInstLdgrHierCd == '01'"> 
  AND HQ_INSID = #{startInstId} 
</if>

这两个案例的核心矛盾，都指向 OGNL 对 "引号内容的类型解析" 和 "类型比较规则"------ 这也是 MyBatis 动态 SQL 中最容易踩的坑。

二、OGNL 表达式的核心规则（必懂）

要解决上述问题，必须先掌握 OGNL 在 MyBatis 中的 3 个关键解析逻辑，这是所有判断的基础：

1. 单引号' '的解析：字符还是字符串？

OGNL 对单引号内容的判断，完全取决于字符数量：

单引号内只有「1 个字符」（如'0'、'A'）→ 解析为「char 类型（字符）」；
单引号内有「2 个及以上字符」（如'01'、'AB'）→ 解析为「String 类型（字符串）」。

这是案例 1 和案例 2 结果差异的核心原因，很多开发者误以为 "单引号一定是字符"，实则不然。

2. 双引号" "的解析：固定为字符串

无论双引号内有多少个字符（如"0"、"01"），OGNL 都会统一解析为「String 类型（字符串）」。但要注意：XML 属性值本身需要用引号包裹（单引号或双引号），因此双引号的使用会受 XML 语法限制（比如test用双引号时，内部双引号会被 XML 解析器当作属性结束符，导致语法错误）。

3. 类型比较规则：严格优先，自动转换为辅

OGNL 比较两个值时，遵循 "先看类型，再看值" 的逻辑：

若类型相同：直接比较值是否相等（如 String 与 String、int 与 int）；
若类型不同 ：仅在 "字符串与数字" 之间会尝试自动类型转换（字符串转数字），其他类型组合（如 String 与 char）直接判定为不相等。

三、逐案拆解：为什么结果不一样？

结合上述规则，我们重新分析两个案例，所有 "反直觉" 的现象都会迎刃而解。

案例 1：变量值为 "0"（字符串）的三种写法

变量startInstLdgrHierCd的类型是 String，值为 "0"，我们逐一拆解三种写法的判断逻辑：

写法 1： → 不成立

右边'0'：1 个字符 → OGNL 解析为「char 类型」；
左边变量：String 类型；
比较逻辑：String 与 char 类型不同，且 OGNL 不支持这两种类型的自动转换 → 直接判定为不相等（结果为 false）。

类比 Java 代码：String a = "0"; char b = '0'; a == b → 结果 false。

写法 2： → 成立

右边0：无引号 → OGNL 解析为「int 类型（数字）」；
左边变量：String 类型；
比较逻辑：String 与 int 类型不同，但 OGNL 支持 "字符串转数字" 的自动转换 → 字符串 "0" 转成数字 0 后，与右边的 0 相等（结果为 true）。

类比 Java 代码：String a = "0"; int b = 0; Integer.parseInt(a) == b → 结果 true。

写法 3： → 成立

外层test用单引号包裹：内部的"0"不会被 XML 解析器误判，OGNL 正常解析为「String 类型」；

右边"0"：双引号 → 解析为 String 类型；

左边变量：String 类型；

比较逻辑：类型相同（均为 String），值均为 "0" → 判定为相等（结果为 true）。

案例 2：变量值为 "01"（字符串）的写法

变量startInstLdgrHierCd的类型是 String，值为 "01"，分析<if test="startInstLdgrHierCd == '01'">：

右边'01'：2 个字符 → OGNL 解析为「String 类型」；

左边变量：String 类型；

比较逻辑：类型相同（均为 String），值均为 "01" → 判定为相等（结果为 true）。

这就解释了为什么 "同样是单引号"，值为 "0" 时不生效，值为 "01" 时却生效 ------ 核心是单引号内字符数量改变了解析后的类型。

四、避坑指南：MyBatis OGNL 的最佳实践

通过以上分析，我们可以总结出 3 条实用规则，彻底避免 OGNL 表达式的类型混淆问题：

1. 字符串比较：统一用 "单引号包 test，双引号包值"

这是最安全的写法，能明确指定两边都是 String 类型，完全避开单引号解析的陷阱：

xml 复制代码

<!-- 推荐写法：test用单引号，值用双引号 -->
<if test='startInstLdgrHierCd == "0"'>
<if test='startInstLdgrHierCd == "01"'>

2. 避免 "字符串与数字" 的直接比较

虽然 OGNL 支持字符串转数字，但这种自动转换存在风险（比如字符串无法转数字时会报错，如"A" == 0会抛出转换异常）。若业务需要比较数字，建议先将变量转为数字类型（如在 Java 代码中处理），再在test中比较：

java 复制代码

// 错误：直接用字符串比较数字
String startInstLdgrHierCd = "0";
// 正确：先转为数字
Integer ldgrHierCd = Integer.parseInt(startInstLdgrHierCd);
param.put("ldgrHierCd", ldgrHierCd);

xml 复制代码

<!-- 此时两边都是int类型，无转换风险 -->
<if test="ldgrHierCd == 0">

3. 单引号仅用于 "单个字符" 的比较（谨慎使用）

若确实需要比较 char 类型（如变量是 Character 类型），再用单引号，且务必确保值是单个字符：

xml 复制代码

<!-- 变量是Character类型时才推荐 -->
<if test="charVar == 'Y'">

五、总结

MyBatis 的 OGNL 表达式看似简单，实则暗藏 "类型解析" 的细节。很多开发者踩坑的本质，是忽略了 "单引号的字符数量影响类型" 和 "OGNL 的自动转换规则"。

记住核心结论：

单引号内 1 个字符→char，≥2 个字符→String；
双引号永远是 String，推荐用test='变量 == "值"'；
避免字符串与数字直接比较，优先统一类型。

掌握这些规则后，你就能轻松应对 MyBatis 动态 SQL 的各种条件判断，再也不用为 "条件不生效" 而头疼了！