上个月我们团队批量生成了一批 MyBatis 的 CRUD 代码，编译、启动、单元测试一路绿到底。结果前端一调订单查询接口，直接抛了 org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)。排查日志时，能看到 Mapper 接口方法混在调用链里，但就是找不到 XML 里对应的 statement id。最后定位到一个大家都不愿意承认的细节：方法名 selectUserByuserId 里，By 后面的 u 没有大写，而 XML 里写成了 selectUserByUserId。就这一个字母的大小写，把联调时间搭进去一个下午。
MyBatis 在初始化时会把 mapper XML 里的每个 <select>、<insert> 等 statement id 注册到 Configuration，运行时通过"接口全限定名 + 方法名"去查 statement id。如果 XML 里写的是 selectUserByUserId，而接口方法是 selectUserByuserId，这个查找就会落空，最终抛出 Invalid bound statement (not found)。这个绑定是纯字符串匹配，不区分语义，大小写不同就是两个 id。而问题通常出在代码生成模板：生成器拿到 PK 字段名 userId，直接拼到 By 后面，没有把首字母 u 转成大写 U。所以生成的默认方法名变成了 selectUserByuserId。如果五层都用这个名字，编译和运行确实不会报错，但不符合 Java 驼峰规范，阿里规约、Sonar 等工具会报警，代码评审也会被扣分。
这种坑之所以难查，是因为它有两种截然不同的表现形态。第一种是"五层都错但一致"：XML、Mapper、Service、Impl、Controller 全部使用 selectUserByuserId。编译能过，运行也能过，甚至接口能正常返回。问题藏得很深，只有 lint 或眼里有驼峰规范的人才会发现。第二种是"五层不一致"：例如 Mapper 接口写 selectUserByuserId，XML 写 selectUserByUserId，或者 Service 里调用 mapper.selectUserByUserId 但接口方法只有 selectUserByuserId。这种情况下，编译可能通过或失败，取决于不一致发生的位置；XML 和 Mapper 不一致时往往编译期毫无感知，直到运行期才炸出 Invalid bound statement (not found)。最迷惑的是，日志通常只告诉你某个 statement id 找不到，不会直接提示"By 后面首字母大小写不一致"。排查时眼睛很难从一个长方法名里揪出那个不起眼的 u。
想快速把这类问题翻出来，可以直接用 grep 正则匹配 By 后紧跟小写字母的情况：
bash
# 检查 mapper XML
grep -rn 'By[a-z]' --include='*.xml' src/main/resources/mapper
# 检查 Java Mapper 接口
grep -rn 'By[a-z]' --include='*Mapper.java' src/main/java只要这两条命令没有任何输出，就说明当前代码里不存在 By 后面首字母小写的方法名。如果想把文件清单列出来，可以加一个 -l 参数只看文件名。
优先修复生成器模板，在拼方法名之前把 PK 字段首字母转成大写：
java
String pk = "userId";
String suffix = Character.toUpperCase(pk.charAt(0)) + pk.substring(1);
String methodName = "selectUserBy" + suffix; // selectUserByUserId对于已经生成的存量代码，可以用 Perl 做批量替换，它比 sed 的 \U 在 macOS 上更稳：
bash
# 先备份或 git diff 确认范围
find . -name '*.xml' -path '*/mapper/*' -exec perl -pi -e 's/By([a-z])/By\u$1/g' {} \;
find . -name '*.java' -exec perl -pi -e 's/By([a-z])/By\u$1/g' {} \;改完之后务必执行一次全量编译，让编译器把 Service、Impl、Controller 里还没同步的调用点暴露出来。批量替换不是万能药，必须配合编译和测试确认。
❌ 验收清单
- 只改了 XML 或只改了 Mapper 接口，五层命名没有同步。
- 批量替换时不限定范围，改完不 diff、不编译、不跑测试。
- 修复后只看"五层一致"就收工，忽略 Java 驼峰规范本身是否达标。
✅ 验收清单
- XML、Mapper、Service、Impl、Controller 五层中的 By+PK 方法名大小写完全一致。
- By 后面的 PK 名首字母大写，例如
selectUserByUserId。 grep -rn 'By[a-z]' --include='*.xml' src/main/resources/mapper和对应 Java 检查均无输出。- 项目能通过
mvn test，接口调用不再触发Invalid bound statement (not found)。
如果你也被 MyBatis 命名大小写或者五层方法名同步坑过，欢迎评论区聊聊你的排查经历。