配了二级缓存,为什么下一次仍访问数据库?
先区分同一 SqlSession 的本地缓存与跨会话的 mapper namespace 缓存。二级缓存需要启用并在适当的提交或关闭边界发布;同一 namespace 的更新通常会清空该缓存。没有实际 SQL 计数,不能只看返回值就判断命中。
本例 MyBatis 3.5.16,H2 2.2.224,使用只读缓存配置与 String 结果,避免把对象序列化要求混入实验。它没有验证 MySQL 隔离级别或 Spring 事务管理器。
复现实验
先采用依赖版本与完整 Maven 配置中的 POM。将下面完整测试类保存为 src/test/java/site/CacheExampleTest.java,在项目目录执行 mvn -Dtest=CacheExampleTest test。首次运行需要下载依赖。
package site;
import java.lang.reflect.*;
import java.sql.*;
import java.util.concurrent.atomic.AtomicInteger;
import org.apache.ibatis.annotations.*;
import org.apache.ibatis.datasource.unpooled.UnpooledDataSource;
import org.apache.ibatis.mapping.Environment;
import org.apache.ibatis.session.*;
import org.apache.ibatis.transaction.jdbc.JdbcTransactionFactory;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;
class CacheExampleTest {
@CacheNamespace(readWrite=false)
interface Labels {
@Select("SELECT label FROM labels WHERE id=#{id}") String read(int id);
@Update("UPDATE labels SET label=#{label} WHERE id=#{id}") int change(@Param("id") int id, @Param("label") String label);
}
static Object invoke(Object target, Method method, Object[] args) throws Throwable {
try { return method.invoke(target,args); } catch (InvocationTargetException e) { throw e.getCause(); }
}
static class CountingSource extends UnpooledDataSource {
final AtomicInteger selects=new AtomicInteger();
CountingSource() { super("org.h2.Driver","jdbc:h2:mem:cache;DB_CLOSE_DELAY=-1","sa",""); }
public Connection getConnection() throws SQLException {
Connection real=super.getConnection();
return (Connection)Proxy.newProxyInstance(getClass().getClassLoader(),new Class[]{Connection.class},(proxy,method,args)->{
Object value=invoke(real,method,args);
if (method.getName().equals("prepareStatement") && args[0].toString().startsWith("SELECT")) {
return Proxy.newProxyInstance(getClass().getClassLoader(),new Class[]{PreparedStatement.class},(p,m,a)->{
if (m.getName().equals("execute") || m.getName().equals("executeQuery")) selects.incrementAndGet();
return invoke(value,m,a);
});
}
return value;
});
}
}
@Test void cache() throws Exception {
var ds=new CountingSource();
try(var connection=ds.getConnection();var sql=connection.createStatement()) {
sql.execute("CREATE TABLE labels(id INT PRIMARY KEY,label VARCHAR(30))");
sql.execute("INSERT INTO labels VALUES(1,'v1')");
}
var configuration=new Configuration(new Environment("demo",new JdbcTransactionFactory(),ds));
configuration.addMapper(Labels.class);
var factory=new SqlSessionFactoryBuilder().build(configuration);
try(var session=factory.openSession()) {
var mapper=session.getMapper(Labels.class);
assertEquals("v1",mapper.read(1)); assertEquals("v1",mapper.read(1));
assertEquals(1,ds.selects.get()); session.commit();
}
try(var session=factory.openSession()) {
assertEquals("v1",session.getMapper(Labels.class).read(1)); assertEquals(1,ds.selects.get());
}
try(var session=factory.openSession()) { session.getMapper(Labels.class).change(1,"v2"); session.commit(); }
try(var session=factory.openSession()) { assertEquals("v2",session.getMapper(Labels.class).read(1)); assertEquals(2,ds.selects.get()); }
System.out.println("selects-before-update=1; selects-after-update=2; value=v2");
}
}
预期输出 selects-before-update=1; selects-after-update=2; value=v2。两次同会话查询只发一次 SELECT;提交关闭后新会话从二级缓存取值;更新提交后再查发出第二次 SELECT,得到 v2。
常见误区与边界
只配置全局 cacheEnabled 不等于每个 mapper 都启用二级缓存。跨 namespace 或直接在数据库里改数据可能绕开失效链;多应用实例也不能把进程内缓存当成一致性方案。readOnly=true 时返回对象共享,应避免修改缓存对象。
排查时记录 session、事务提交点、namespace、SQL 参数和更新路径。本例不提供任何命中率或性能承诺。
下一步:固定实验依赖版本。
整理范围与出处
本次依据下方版本资料整理说明与示例;历史导入资料的来源状态单独列示,不将技术参考认作原作者信息。原始发布日期与地址保留。