## 1. 启动故障排查步骤
1. 检查配置文件
2. 检查端口占用
3. 检查权限
4. 检查内存
5. 检查持久化文件
6. 查看日志

## 2. 连接故障排查步骤
1. 检查网络连接
2. 检查认证信息
3. 检查防火墙
4. 检查连接数限制
5. 检查Redis服务状态
6. 查看日志

## 3. 运行故障排查步骤
1. 检查内存使用
2. 检查持久化状态
3. 检查主从复制状态
4. 检查命令执行情况
5. 查看日志

学习交流加群风哥QQ113257174

Part03-生产环境项目实施方案

3.1 启动故障排查

## 1. 检查配置文件
$ vi /redis/app/redis.conf

# 检查配置文件语法
$ /redis/app/bin/redis-server –test-config /redis/app/redis.conf

# 输出示例
# oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
# Redis version=7.0.12, bits=64, commit=00000000, modified=0, pid=12345, just started
# Configuration loaded

## 2. 检查端口占用
$ netstat -tlnp | grep 6379

# 输出示例（端口被占用）
tcp 0 0 192.168.1.100:6379 0.0.0.0:* LISTEN 54321/redis-server

# 杀死占用端口的进程
$ kill -9 54321

## 3. 检查权限
$ ls -la /redis/app/redis.conf
$ ls -la /redis/fgdata/
$ ls -la /redis/log/

# 输出示例
-rw-r–r– 1 root root 10240 Apr 7 10:00 /redis/app/redis.conf
drwxr-xr-x 2 root root 4096 Apr 7 10:00 /redis/fgdata/
drwxr-xr-x 2 root root 4096 Apr 7 10:00 /redis/log/

## 4. 检查内存
$ free -h

# 输出示例
total used free shared buff/cache available
Mem: 32G 10G 5G 200M 17G 20G

## 5. 检查持久化文件
$ redis-check-rdb /redis/fgdata/dump.rdb
$ redis-check-aof /redis/fgdata/appendonly.aof

## 6. 查看日志
$ tail -f /redis/log/redis.log

# 启动Redis
$ systemctl start redis

# 查看启动状态
$ systemctl status redis

## 1. 检查网络连接
$ ping 192.168.1.100

# 输出示例
PING 192.168.1.100 (192.168.1.100) 56(84) bytes of data.
64 bytes from 192.168.1.100: icmp_seq=1 ttl=64 time=0.123 ms

# 检查端口
$ telnet 192.168.1.100 6379

# 输出示例（成功）
Trying 192.168.1.100…
Connected to 192.168.1.100.
Escape character is ‘^]’.

# 输出示例（失败）
Trying 192.168.1.100…
telnet: connect to address 192.168.1.100: Connection refused

## 2. 检查认证信息
$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 ping

# 输出示例（需要认证）
(error) NOAUTH Authentication required.

$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 -a fgedu@2026 ping

# 输出示例（认证成功）
PONG

## 3. 检查防火墙
$ firewall-cmd –list-ports

# 输出示例
6379/tcp

# 如果没有6379端口，添加
$ firewall-cmd –permanent –add-port=6379/tcp
$ firewall-cmd –reload

## 4. 检查连接数限制
$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 -a fgedu@2026 config get maxclients

# 输出示例
1) “maxclients”
2) “10000”

# 查看当前连接数
$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 -a fgedu@2026 info clients | grep connected_clients

# 输出示例
connected_clients:10

## 5. 检查Redis服务状态
$ systemctl status redis

# 输出示例
● redis.service – Redis Server
Loaded: loaded (/etc/systemd/system/redis.service; enabled; vendor preset: disabled)
Active: active (running) since Wed 2026-04-07 10:00:00 CST; 1min ago
Main PID: 12345 (redis-server)
Tasks: 4
Memory: 100.0M
CPU: 0.1%
CGroup: /system.slice/redis.service
└─12345 /redis/app/bin/redis-server 192.168.1.100:6379

## 1. 查看启动日志
$ grep -i “start” /redis/log/redis.log

# 输出示例
2026-04-07 10:00:00.000 [12345] 07 Apr 10:00:00.000 # Redis server started, Redis version 7.0.12
2026-04-07 10:00:00.000 [12345] 07 Apr 10:00:00.000 # Configuration loaded

## 2. 查看错误日志
$ grep -i “error” /redis/log/redis.log

# 输出示例
2026-04-07 09:59:00.000 [54321] 07 Apr 09:59:00.000 # Creating Server TCP listening socket 192.168.1.100:6379: bind: Address already in use

## 3. 查看警告日志
$ grep -i “warning” /redis/log/redis.log

# 输出示例
2026-04-07 10:00:00.000 [12345] 07 Apr 10:00:00.000 # WARNING: The TCP backlog setting of 511 cannot be enforced because /proc/sys/net/core/somaxconn is set to the lower value of 128.

## 4. 查看连接日志
$ grep -i “connect” /redis/log/redis.log

# 输出示例
2026-04-07 10:01:00.000 [12345] 07 Apr 10:01:00.000 * Accepted 192.168.1.101:12345
2026-04-07 10:02:00.000 [12345] 07 Apr 10:02:00.000 * Closing connection 192.168.1.101:12345

## 5. 查看持久化日志
$ grep -i “persist” /redis/log/redis.log

# 输出示例
2026-04-07 10:05:00.000 [12345] 07 Apr 10:05:00.000 * Background saving started by pid 12346
2026-04-07 10:05:01.000 [12346] 07 Apr 10:05:01.000 * DB saved on disk
2026-04-07 10:05:01.000 [12345] 07 Apr 10:05:01.000 * Background saving terminated with success

## 1. 检查网络接口
$ ifconfig

# 输出示例
enp0s3: flags=4163 mtu 1500
inet 192.168.1.100 netmask 255.255.255.0 broadcast 192.168.1.255
inet6 fe80::a00:27ff:fe9a:4e5a prefixlen 64 scopeid 0x20 ether 08:00:27:9a:4e:5a txqueuelen 1000 (Ethernet)
RX packets 1000 bytes 1000000 (976.5 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 1000 bytes 1000000 (976.5 KiB)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0

## 2. 检查路由
$ route -n

# 输出示例
Kernel IP routing table
Destination Gateway Genmask Flags Metric Ref Use Iface
0.0.0.0 192.168.1.1 0.0.0.0 UG 100 0 0 enp0s3
192.168.1.0 0.0.0.0 255.255.255.0 U 100 0 0 enp0s3

## 3. 检查DNS
$ cat /etc/resolv.conf

# 输出示例
nameserver 8.8.8.8
nameserver 8.8.4.4

## 4. 检查网络延迟
$ ping -c 5 192.168.1.100

# 输出示例
PING 192.168.1.100 (192.168.1.100) 56(84) bytes of data.
64 bytes from 192.168.1.100: icmp_seq=1 ttl=64 time=0.123 ms
64 bytes from 192.168.1.100: icmp_seq=2 ttl=64 time=0.112 ms
64 bytes from 192.168.1.100: icmp_seq=3 ttl=64 time=0.105 ms
64 bytes from 192.168.1.100: icmp_seq=4 ttl=64 time=0.118 ms
64 bytes from 192.168.1.100: icmp_seq=5 ttl=64 time=0.109 ms

— 192.168.1.100 ping statistics —
5 packets transmitted, 5 received, 0% packet loss, time 4000ms
rtt min/avg/max/mdev = 0.105/0.113/0.123/0.007 ms

## 5. 检查网络连接
$ netstat -an | grep 6379

# 输出示例
tcp 0 0 192.168.1.100:6379 0.0.0.0:* LISTEN
tcp 0 0 192.168.1.100:6379 192.168.1.101:12345 ESTABLISHED

## 6. 检查防火墙
$ firewall-cmd –list-all

# 输出示例
public (active)
target: default
icmp-block-inversion: no
interfaces: enp0s3
sources:
services: ssh dhcpv6-client
ports: 6379/tcp
protocols:
masquerade: no
forward-ports:
source-ports:
icmp-blocks:
rich rules:

风哥提示：Redis接口限流是保护系统的重要机制，合理的限流策略可以防止系统过载，确保系统的稳定性和可用性。在实际应用中，需要根据具体业务场景和数据特点，选择合适的限流算法和策略。

Part04-生产案例与实战讲解

4.1 启动故障案例

## 案例1：端口被占用

### 症状
启动Redis时提示端口被占用

### 排查过程
1. 查看端口占用情况
$ netstat -tlnp | grep 6379

2. 发现端口被占用，杀死占用进程
$ kill -9 54321

3. 重新启动Redis
$ systemctl start redis

4. 验证启动状态
$ systemctl status redis

### 解决方案
– 确保没有其他Redis实例在运行
– 配置不同的端口号用于多实例

## 案例2：配置文件错误

### 症状
启动Redis时提示配置文件错误

### 排查过程
1. 检查配置文件语法
$ /redis/app/bin/redis-server –test-config /redis/app/redis.conf

2. 修复配置文件中的错误
$ vi /redis/app/redis.conf

3. 重新启动Redis
$ systemctl start redis

### 解决方案
– 使用配置文件检查工具验证配置
– 备份配置文件，避免误修改

## 案例3：持久化文件损坏

### 症状
启动Redis时提示持久化文件损坏

### 排查过程
1. 检查RDB文件
$ redis-check-rdb /redis/fgdata/dump.rdb

2. 检查AOF文件
$ redis-check-aof /redis/fgdata/appendonly.aof

3. 修复损坏的文件或删除重建
$ redis-check-aof –fix /redis/fgdata/appendonly.aof

4. 重新启动Redis
$ systemctl start redis

### 解决方案
– 定期备份持久化文件
– 启用混合持久化提高可靠性

## 案例1：认证失败

### 症状
客户端连接Redis时提示认证失败

### 排查过程
1. 检查Redis配置文件中的密码
$ grep requirepass /redis/app/redis.conf

2. 验证密码是否正确
$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 -a fgedu@2026 ping

3. 重置密码（如果忘记）
$ vi /redis/app/redis.conf
requirepass fgedu@2026

4. 重启Redis
$ systemctl restart redis

### 解决方案
– 使用强密码
– 定期更换密码
– 存储密码在安全的地方

## 案例2：连接被拒绝

### 症状
客户端连接Redis时提示连接被拒绝

### 排查过程
1. 检查Redis服务状态
$ systemctl status redis

2. 检查端口监听
$ netstat -tlnp | grep 6379

3. 检查防火墙
$ firewall-cmd –list-ports

4. 检查绑定地址
$ grep bind /redis/app/redis.conf

### 解决方案
– 确保Redis服务正在运行
– 确保防火墙允许6379端口
– 确保绑定地址正确

## 案例3：连接数达到上限

### 症状
客户端连接Redis时提示连接数达到上限

### 排查过程
1. 查看连接数限制
$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 -a fgedu@2026 config get maxclients

2. 查看当前连接数
$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 -a fgedu@2026 info clients | grep connected_clients

3. 增加连接数限制
$ vi /redis/app/redis.conf
maxclients 20000

4. 重启Redis
$ systemctl restart redis

### 解决方案
– 根据实际需求调整连接数限制
– 优化客户端连接池
– 及时关闭不需要的连接

## 案例1：网络不通

### 症状
客户端无法连接到Redis服务器

### 排查过程
1. 检查网络连接
$ ping 192.168.1.100

2. 检查端口
$ telnet 192.168.1.100 6379

3. 检查防火墙
$ firewall-cmd –list-ports

4. 检查网络配置
$ ifconfig

### 解决方案
– 确保网络连接正常
– 确保防火墙允许6379端口
– 确保网络配置正确

## 案例2：网络延迟高

### 症状
Redis响应缓慢

### 排查过程
1. 检查网络延迟
$ ping -c 10 192.168.1.100

2. 检查网络带宽
$ iperf3 -c 192.168.1.100

3. 检查Redis性能
$ /redis/app/bin/redis-cli -h 192.168.1.100 -p 6379 -a fgedu@2026 info stats | grep latency

### 解决方案
– 优化网络配置
– 增加网络带宽
– 减少网络传输距离

## 案例1：文件权限不足

### 症状
启动Redis时提示权限不足

### 排查过程
1. 检查文件权限
$ ls -la /redis/app/redis.conf
$ ls -la /redis/fgdata/
$ ls -la /redis/log/

2. 修复权限
$ chown -R root:root /redis/app/
$ chown -R root:root /redis/fgdata/
$ chown -R root:root /redis/log/

3. 重新启动Redis
$ systemctl start redis

### 解决方案
– 确保文件权限正确
– 使用统一的用户管理文件权限

## 案例2：SELinux限制

### 症状
启动Redis时提示权限被拒绝，即使文件权限正确

### 排查过程
1. 检查SELinux状态
$ sestatus

2. 临时关闭SELinux
$ setenforce 0

3. 重新启动Redis
$ systemctl start redis

4. 永久关闭SELinux或配置SELinux规则
$ vi /etc/selinux/config
SELINUX=disabled

### 解决方案
– 配置SELinux规则允许Redis运行
– 或在测试环境中临时关闭SELinux

更多学习教程公众号风哥教程itpux_com

Part05-风哥经验总结与分享

5.1 最佳实践

Redis启动连接故障排查最佳实践：

• 定期检查：定期检查Redis服务状态和配置，学习交流加群风哥微信: itpux-com
• 日志监控：实时监控Redis日志，及时发现问题
• 备份配置：定期备份Redis配置文件
• 权限管理：合理设置文件权限和用户权限
• 网络配置：确保网络连接稳定，防火墙配置正确
• 资源监控：监控CPU、内存、磁盘等资源使用情况

5.2 常见问题解决方案