---
title: Redis 缓存配置指南
keywords: [Redis, 缓存, 配置, 连接池, 超时]
summary: Redis 缓存的配置参数说明、连接池设置和常见问题排查
category: infrastructure
---

# Redis 缓存配置指南

## 基础配置

### 连接参数
```yaml
spring:
  redis:
    host: localhost
    port: 6379
    password: your_password
    database: 0
    timeout: 3000ms
```

### 连接池配置
```yaml
spring:
  redis:
    lettuce:
      pool:
        max-active: 8
        max-idle: 8
        min-idle: 0
        max-wait: -1ms
```

## 常见问题

### 超时问题排查

**症状**：Redis 操作超时

**排查步骤**：
1. 检查网络连接：`ping redis_host`
2. 检查 Redis 服务状态：`redis-cli ping`
3. 查看慢查询日志：`redis-cli slowlog get 10`
4. 检查连接池状态

**解决方案**：
- 增加超时时间
- 优化慢查询
- 调整连接池大小

### 连接数过多

**症状**：达到 Redis 最大连接数限制

**排查**：
```bash
redis-cli info clients
```

**解决**：
- 调整 `maxclients` 参数
- 检查连接泄漏
- 启用连接池复用