Spring Content与Hibernate查询优化：商品图片展示时重复查询过多的解决方法

我来帮你拆解这个问题，并且给出落地的优化方案：

问题根源分析 #

你遇到的是重复查询叠加N+1问题，核心原因有两个：

1. 页面里每个商品的图片URL会触发浏览器单独请求/data/{id}接口；
2. Spring Content默认的ContentStore实现，在处理每个图片请求时会多次调用findById()加载同一个Product实体——从你的日志能看到，单个图片请求居然触发了3次完全重复的SQL查询。

对应你给出的场景：1次列表查询+2个商品×3次重复查询，正好是7条SQL，完全匹配你的日志输出。

优化方案 #

1. 开启Hibernate二级缓存（最推荐、最简单） #

这是解决重复查询最直接的方案，让Hibernate把已经查询过的Product实体缓存起来，后续再查询同一个ID的实体时直接从缓存取，不用再走数据库。

步骤1：配置二级缓存

在application.properties中添加以下配置（以Ehcache为例，也可以用Caffeine等其他缓存提供商）：

# 开启Hibernate二级缓存
spring.jpa.properties.hibernate.cache.use_second_level_cache=true
# 指定缓存区域工厂
spring.jpa.properties.hibernate.cache.region.factory_class=org.hibernate.cache.jcache.JCacheRegionFactory
# 只缓存标记了@Cacheable的实体
spring.jpa.properties.javax.persistence.sharedCache.mode=ENABLE_SELECTIVE

步骤2：标记实体为可缓存

在Product实体类上添加@Cacheable注解：

@Entity
@Cacheable
public class Product {
    // 原有字段、构造方法保持不变
}

配置完成后，第一次查询某个Product实体后，后续所有的findById()请求都会直接从缓存获取，不会再生成新的SQL语句。

2. 自定义ContentStore实现（进阶优化） #

如果不想依赖二级缓存，你可以自定义ProductImageStore的实现，确保每个图片请求只加载一次Product实体：

@Repository
public class CustomProductImageStore implements ContentStore<Product, String> {

    @Autowired
    private ProductRepository productRepository;
    @Autowired
    private ContentStore<Product, String> defaultContentStore;

    @Override
    public InputStream getContent(Product entity) {
        // 检查实体是否未初始化，手动加载一次
        if (entity.getId() != null && !Hibernate.isInitialized(entity)) {
            entity = productRepository.findById(entity.getId())
                    .orElseThrow(() -> new RuntimeException("Product not found"));
        }
        return defaultContentStore.getContent(entity);
    }

    // 其他方法直接委托给默认实现即可
    @Override
    public Product setContent(Product entity, InputStream content) {
        return defaultContentStore.setContent(entity, content);
    }

    @Override
    public void unsetContent(Product entity) {
        defaultContentStore.unsetContent(entity);
    }

    @Override
    public boolean hasContent(Product entity) {
        return defaultContentStore.hasContent(entity);
    }
}

这个方法通过手动控制实体加载次数，避免重复查询，但需要你对Spring Content的工作机制有一定了解。

3. 嵌入Base64图片（仅适合小图场景） #

如果你的商品图片都是小尺寸缩略图，可以把图片转成Base64编码直接嵌入页面，这样就不需要浏览器发送额外的图片请求，从根源上避免后续的查询。比如在列表查询时提前把图片内容转成Base64，然后在Thymeleaf中直接使用：

<img th:src="data:image/jpeg;base64,${product.base64Image}" />

注意：这个方法会增加页面HTML体积，不适合大图场景。

效果验证 #

配置二级缓存后，访问商品列表时只会有1次列表查询，每个图片请求的3次实体查询都会命中缓存，不会生成新的SQL。访问单个图片端点时，第一次会触发1次查询，后续请求都直接从缓存获取。

内容的提问来源于stack exchange，提问作者leonaugust