当需要写中文技术文档、README、博客、教程或技术说明时使…

# Redis 缓存服务 README

一、服务简介

团队内部缓存服务，基于 Redis 6.2，端口 6379，用于会话存储、热点数据缓存与分布式锁。

二、三个接口用法

1. SET_CACHE —— 写入缓存

```http

POST /api/cache/set

{"key": "user:1001", "value": "{\"name\":\"张三\"}", "ttl": 600}

```

返回 {"code":0, "msg":"ok"}。ttl 单位为秒，不传则默认 3600。

2. GET_CACHE —— 读取缓存

```http

GET /api/cache/get?key=user:1001

```

返回 {"code":0, "data":{"name":"张三"}}；key 不存在时 data 为 null。

3. DEL_CACHE —— 删除缓存

```http

DELETE /api/cache/del?key=user:1001

```

支持批量：?key=user:1001&key=user:1002。

三、部署步骤

```bash

# 1. 拉取镜像

docker pull redis:6.2

# 2. 启动服务（挂载配置与数据目录）

docker run -d --name team-redis -p 6379:6379 \

-v /data/redis/conf/redis.conf:/etc/redis/redis.conf \

-v /data/redis/data:/data redis:6.2 \

redis-server /etc/redis/redis.conf --requirepass Team@2024

# 3. 启动缓存网关（封装上述三接口）

cd /opt/cache-gateway && docker compose up -d

# 4. 验证

curl http://10.0.0.5:8080/api/cache/get?key=health

```

配置文件需设置 maxmemory 2gb、maxmemory-policy allkeys-lru。

四、常见报错及解决

1. MISCONF Redis is configured to save RDB snapshots：磁盘写满或权限不足导致快照失败。执行 df -h 检查磁盘，清理空间后运行 redis-cli -a Team@2024 config set stop-writes-on-bgsave-error no（临时），根治需修复目录权限 chown -R 999:999 /data/redis/data。

2. WRONGPASS invalid username-password：密码错误。核对网关 application.yml 中 spring.redis.password 与 redis.conf 的 requirepass 是否一致，改后需重启网关容器。

3. OOM command not allowed when used memory > 'maxmemory'：内存超限。执行 redis-cli -a Team@2024 info memory 查看用量，清理无用 key，或调大 maxmemory 并确认淘汰策略为 allkeys-lru。

4. MOVED 8421 10.0.0.6:6379：集群模式下 key 落在其他分片。客户端需启用集群模式（如 Lettuce 自动重定向），或运