常见问题

部署相关

1、部署了本项目，还需要部署FreeRadius或者其它Radius软件吗？

不需要，本项目已经实现了所有Radius功能，不需要再部署其它Radius软件。

2、数据库连接失败

# 检查MySQL服务
systemctl status mysql

# 检查端口
netstat -tlnp | grep 3306

# 检查用户权限
mysql -u root -p -e "SHOW GRANTS FOR 'ruoyi'@'%';"

3、端口冲突

# 查看端口占用
netstat -tlnp | grep 8080

# 停止占用进程
kill -9 <PID>

# 或修改应用端口
# 在application.yml中修改 server.port

4、内存不足

# 调整JVM参数
JAVA_OPTS="-Xms1g -Xmx2g -XX:+UseG1GC"

# 查看内存使用
top -p $(pgrep -f ruoyi-admin)

5、使用服务名访问不到该服务

• 比如ruoyi-admin服务通过服务名调用ruoyi-mysql数据库服务时，调用不到，但通过IP地址正常，那么问题应该是出在Docker网络问题上了，根据以下方法进行修复。

# 查看所有网络
docker network ls

# 查看 ry_network 详情
docker network inspect ry_network 2>/dev/null || echo "ry_network 不存在"

# 查看 docker_ry_network 详情
docker network inspect docker_ry_network 2>/dev/null && echo "docker_ry_network 存在"

# 我们默认使用ry_network网络，但docker-compose在部署时，有时会自动加上前缀变成docker_ry_network，所以请确认网络名

# 查看网络详情
docker network inspect ry_network

# 检查容器是否连接到同一个网络
docker inspect ruoyi-admin | grep -A 5 Networks
docker inspect ruoyi-mysql | grep -A 5 Networks

# 测试容器间网络连通性
docker exec ruoyi-admin ping ruoyi-mysql
docker exec ruoyi-admin cat /etc/hosts | grep ruoyi-mysql

# 测试 DNS 解析
docker exec ruoyi-admin nslookup ruoyi-mysql
docker exec ruoyi-admin ping -c 1 ruoyi-mysql

# 删除不用的网络
docker network rm ry_network

# 创建网络
docker network create -d bridge ry_network

# 验证 查看所有网络
docker network ls

# 查看所有网络 查看网络详细信息
docker network inspect ry_network

6、访问不到Redis服务

• 程序访问不到Redis缓存，有以下几种原因：

1. Redis没有正常部署成功，比如挂载目录（/home/ruoyi/redis/conf/redis.conf和/home/ruoyi/redis/data）没有权限,给目录添加权限：chmod 777 -R /home/ruoyi/redis/
2. Redis服务需要密码访问，默认密码是ruoyi123,请以密码方式连接缓存服务。

配置相关

1、认证时，页面提示设备不存在

1. 阅读“用户手册”中5.1 BAS设备管理是否正确配置。
2. 检查路由器设备的配置是否与“认证配置”中配置一致。
3. 存在此问题，大概率是BAS设备配置的某些参数不对。

2、认证时，页面提示用户验证不通过

1. 阅读“用户手册”中5.2 认证用户管理及5.3 认证模板管理是否正确配置。
2. 存在此问题，大概率是认证规则模板中设置了认证策略，而用户没对应的参数设置，比如：认证模板中设置了认证方式为账号密码认证，认证策略中配置了IP地址，但用户管理中没有给用户IP地址赋值或者IP地址与当前登录的IP地址不一致，这样就会导致认证失败。