MyBatis-Plus 插入加密密码时出现 Illegal Group Reference 错误解析

MyBatis-Plus 插入加密密码时出现 Illegal Group Reference 错误解析

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus

问题现象

在使用 MyBatis-Plus 3.5.8 版本时，当开发者尝试将 BCryptPasswordEncoder 加密后的密码（如 $2a$10$Zz/LMEvwR2V8H/xQhtyM9Ob7PLeKHV3ClajgFDTwX15PR7FiQK1U6）存入数据库时，系统会抛出 IllegalArgumentException: Illegal group reference 异常。值得注意的是，尽管抛出异常，数据实际上能够正常插入数据库。

错误分析

该问题本质上并非 MyBatis-Plus 框架本身的缺陷，而是与某些 SQL 日志拦截插件相关。从堆栈信息可以清晰看到，错误发生在 com.linkkou.mybatis.log.LogInterceptor 这个日志拦截器中。

根本原因

1. BCrypt 密码格式特性：BCrypt 加密后的字符串包含特殊字符 $，这在正则表达式中具有特殊含义（表示分组引用）。

2. 日志拦截器问题：某些 SQL 日志打印插件（如 MyBatis Log Plugin）在处理包含特殊字符的参数时，会尝试使用正则表达式进行字符串替换操作。当遇到 $ 字符时，会误将其识别为正则表达式的分组引用符号，从而导致 Illegal group reference 异常。

3. 不影响实际插入：由于这个错误发生在日志记录阶段而非实际 SQL 执行阶段，所以数据能够正常插入数据库。

解决方案

1. 禁用相关插件：在 IDE（如 IntelliJ IDEA）中禁用 MyBatis Log Plugin 等可能干扰 SQL 日志记录的插件。

2. 使用替代日志方案：考虑使用 MyBatis-Plus 自带的 SQL 日志功能或配置标准的 MyBatis 日志实现。

3. 修改日志拦截器：如果必须使用特定日志拦截器，可以修改其实现，避免对参数值进行正则表达式处理，或对特殊字符进行转义处理。

最佳实践建议

1. 密码存储安全：继续使用 BCrypt 等安全哈希算法存储密码是正确的做法，不应因为日志问题而降低安全性。

2. 生产环境日志：在生产环境中，建议避免直接记录包含敏感信息（如密码哈希值）的 SQL 语句。

3. 插件选择：谨慎选择第三方插件，特别是那些会拦截和修改 SQL 执行的工具，确保它们经过充分测试且与当前框架版本兼容。

总结

这个问题提醒开发者在集成各种开发工具时需要保持警惕。看似简单的日志记录功能可能会因为实现方式不当而引发意外问题。理解问题的本质后，我们可以做出明智的选择：要么禁用有问题的插件，要么寻找更可靠的替代方案，同时不影响核心业务功能的正常运行。

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus