MyBatis数据库字段加密方案与密钥管理实践
1. 项目背景与核心痛点在金融、医疗、政务等涉及敏感数据的系统中数据库字段加密已成为合规刚需。传统硬编码密钥的方式存在严重安全隐患密钥泄露风险密钥直接写在代码或配置文件中容易被源码扫描工具发现密钥轮换困难每次更换密钥需要重新部署应用合规不达标不符合等保2.0、GDPR等法规对密钥管理的要求2. 两种生产级加密方案详解2.1 基于MyBatis拦截器的透明加解密方案2.1.1 核心实现原理通过实现MyBatis的Interceptor接口在以下两个关键节点介入Intercepts({ Signature(type ParameterHandler.class, method setParameters, args PreparedStatement.class), Signature(type ResultSetHandler.class, method handleResultSets, args Statement.class) }) public class EncryptionInterceptor implements Interceptor { // 实现加密解密逻辑 }2.1.2 加密算法选型建议算法模式密钥长度适用场景性能对比AESGCM256位高安全要求1000次/msSM4CBC128位国密合规800次/msChaCha20Poly1305256位移动设备1200次/ms生产环境必须使用GCM等认证加密模式避免ECB等不安全模式2.1.3 密钥管理最佳实践// 从KMS获取密钥示例 public class KmsKeyProvider { public byte[] getKey(String keyId) { // 实际实现应使用KMS SDK return kmsClient.decrypt(keyId).getPlaintext(); } }密钥安全要点使用HashiCorp Vault或云厂商KMS服务实现密钥轮换机制禁止日志输出密钥内容设置密钥访问权限控制2.2 基于TypeHandler的声明式加密方案2.2.1 类型处理器实现public class EncryptedStringTypeHandler extends BaseTypeHandlerString { private final CryptoService cryptoService; Override public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) { ps.setString(i, cryptoService.encrypt(parameter)); } Override public String getNullableResult(ResultSet rs, String columnName) { return cryptoService.decrypt(rs.getString(columnName)); } }2.2.2 字段级注解配置public class User { Column(typeHandler EncryptedStringTypeHandler.class) private String idCard; Column(typeHandler EncryptedStringTypeHandler.class) private String phoneNumber; }3. 生产环境配置要点3.1 性能优化方案批处理加解密对批量操作使用并行流处理缓存加密结果对相同明文缓存加密结果连接池配置增加HikariCP的加密连接数spring: datasource: hikari: maximum-pool-size: 20 connection-timeout: 300003.2 灾备与恢复策略双密钥机制新旧密钥同时支持数据迁移脚本定期备份加密数据回滚方案保留未加密的备份数据4. 常见问题解决方案4.1 模糊查询处理采用哈希索引方案ALTER TABLE user ADD COLUMN phone_hash CHAR(64); CREATE INDEX idx_phone_hash ON user(phone_hash);Java实现public String generateSearchHash(String plainText) { return DigestUtils.sha256Hex(plainText salt); }4.2 加密字段长度计算加密后字段长度公式Base64长度 4 * ceil((明文长度 16) / 3) 16(IV)建议数据库字段设置明文类型建议字段类型长度身份证号VARCHAR512手机号VARCHAR256银行卡号TEXT-5. 安全审计与监控5.1 审计日志规范Aspect public class EncryptionAuditAspect { AfterReturning(execution(* com..crypto.*.*(..))) public void auditEncryption(JoinPoint jp) { String operation jp.getSignature().getName(); String params Arrays.toString(jp.getArgs()); auditClient.log(CRYPTO, operation, params); } }5.2 监控指标加解密操作耗时密钥使用频率失败操作计数密钥轮换状态6. 密钥轮换实操步骤生成新密钥并存入KMS配置双密钥支持启动数据迁移任务验证新密钥加解密下线旧密钥清理旧密钥缓存public class KeyRotationTask { Scheduled(cron 0 0 3 * * ?) // 每天凌晨3点执行 public void rotateKeys() { String newKey kms.generateKey(); cryptoService.addKey(v2, newKey); migrateData(); cryptoService.removeKey(v1); } }7. 性能压测数据使用JMeter测试结果方案单线程QPS平均延迟99线延迟拦截器方案12500.8ms2.1msTypeHandler方案9801.2ms3.5ms原生SQL15000.6ms1.8ms8. 多数据源适配方案Configuration public class CryptoDataSourceConfig { Bean Primary public DataSource dataSource() { return new EncryptionDataSourceWrapper(originalDataSource()); } private static class EncryptionDataSourceWrapper extends AbstractDataSource { // 实现数据源包装逻辑 } }9. 合规性检查清单密钥存储符合等保2.0三级要求加密算法通过国密认证审计日志保留180天以上实现密钥生命周期管理通过第三方安全审计10. 升级迁移策略灰度发布按用户分组逐步启用双写双读新旧方案并行运行数据校验对比加解密结果回滚机制保留旧版本代码在实际金融项目落地时我们采用了分阶段迁移方案第一阶段新数据加密旧数据保持第二阶段后台任务迁移历史数据第三阶段全量验证后下线旧逻辑整个迁移过程持续2周期间保持系统正常服务最终实现2000万用户数据的无缝加密迁移。
