在Java项目开发中，缓存是优化系统性能的核心组件之一，合理搭建缓存运行环境能够有效降低数据库访问压力，提升接口的响应速度。搭建过程需要结合项目规模和需求选择合适的缓存类型，再完成对应的依赖引入和环境配置。
缓存类型选择
Java项目常用的缓存分为本地缓存和分布式缓存两类，开发者可以根据项目场景选择：
- 本地缓存：适合单体应用，数据存储在应用进程内存中，访问速度极快，常见实现有Ehcache、Caffeine等。
- 分布式缓存：适合微服务或集群部署场景，数据存储在独立的缓存服务中，多节点可共享缓存数据，常见实现有Redis、Memcached等。
本地缓存Ehcache环境搭建
1. 引入依赖
如果是Maven管理的Spring Boot项目，在pom.xml中添加Ehcache依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-cache</artifactId>
</dependency>
<dependency>
<groupId>org.ehcache</groupId>
<artifactId>ehcache</artifactId>
</dependency>
2. 配置Ehcache
在resources目录下创建ehcache.xml配置文件，定义缓存规则：
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd">
<!-- 磁盘缓存路径 -->
<diskStore path="java.io.tmpdir/ehcache"/>
<!-- 默认缓存配置 -->
<defaultCache
maxEntriesLocalHeap="1000"
eternal="false"
timeToIdleSeconds="300"
timeToLiveSeconds="600"
overflowToDisk="true">
</defaultCache>
<!-- 自定义缓存，名称为userCache -->
<cache name="userCache"
maxEntriesLocalHeap="2000"
eternal="false"
timeToIdleSeconds="180"
timeToLiveSeconds="300"
overflowToDisk="true">
</cache>
</ehcache>
3. 启用缓存配置
在Spring Boot启动类上添加@EnableCaching注解开启缓存功能：
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cache.annotation.EnableCaching;
@SpringBootApplication
@EnableCaching
public class CacheDemoApplication {
public static void main(String[] args) {
SpringApplication.run(CacheDemoApplication.class, args);
}
}
分布式缓存Redis环境搭建
1. 安装Redis服务
首先在服务器或本地安装Redis，以Linux系统为例，执行以下命令完成安装启动：
# 下载Redis安装包 wget https://ipipp.com/redis-stable.tar.gz # 解压 tar -zxvf redis-stable.tar.gz cd redis-stable # 编译安装 make && make install # 启动Redis服务 redis-server redis.conf
2. 引入项目依赖
在pom.xml中添加Redis相关依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
3. 配置Redis连接参数
在application.yml中配置Redis服务连接信息：
spring:
redis:
host: 127.0.0.1
port: 6379
password:
database: 0
timeout: 3000ms
lettuce:
pool:
max-active: 8
max-idle: 4
min-idle: 1
max-wait: 1000ms
缓存系统核心配置说明
无论是本地缓存还是分布式缓存，都需要关注以下核心配置参数：
| 配置参数 | 参数说明 | 适用缓存类型 |
|---|---|---|
| maxEntriesLocalHeap | 堆内存中最大缓存条目数，超过后会根据策略淘汰数据 | 本地缓存 |
| timeToIdleSeconds | 缓存条目最大空闲时间，超过该时间未被访问则被淘汰 | 本地缓存、分布式缓存 |
| timeToLiveSeconds | 缓存条目最大存活时间，无论是否被访问，超过后都会被淘汰 | 本地缓存、分布式缓存 |
| max-active | 连接池最大活跃连接数，控制缓存服务的并发连接上限 | 分布式缓存 |
| overflowToDisk | 内存缓存满后是否将数据溢出到磁盘存储 | 本地缓存 |
缓存使用验证
编写简单的测试接口验证缓存环境是否搭建成功：
import org.springframework.cache.annotation.Cacheable;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
// 使用userCache缓存，key为方法参数id
@Cacheable(value = "userCache", key = "#id")
@GetMapping("/user")
public String getUserById(String id) {
// 模拟数据库查询操作
System.out.println("查询数据库获取用户数据，id为：" + id);
return "用户_" + id;
}
}
启动项目后访问接口，第一次请求会打印数据库查询日志，后续相同id的请求不会打印日志，说明缓存已经生效。
注意事项
- 缓存数据需要设置合理的过期时间，避免无效数据长期占用内存。
- 分布式缓存需要配置对应的序列化方式，建议使用JSON序列化减少存储空间。
- 生产环境需要为Redis配置密码，避免未授权访问导致数据泄露。
- 缓存更新时需要保证缓存和数据库的数据一致性，可采用先更新数据库再删除缓存的策略。
Java缓存系统RedisSpring_BootEhcache修改时间：2026-06-27 11:45:30