docs: 添加Docker+Kvrocks登录失败问题的详细故障排除指南

文档更新:
- 在README常见问题排除部分添加专门的Kvrocks登录失败解决方案
- 详细说明问题症状、原因分析和完整的解决步骤
- 提供环境变量配置检查和验证命令

 解决用户反馈:
- 针对用户报告的'账号或密码错误'和'Users数组为空'问题
- 提供完整的诊断和修复流程
- 包含重启服务和验证配置的具体命令

 技术改进:
- 明确标识这是重要修复项
- 提供可复制执行的命令脚本
- 添加配置验证步骤确保修复生效
This commit is contained in:
katelya
2025-09-04 23:42:46 +08:00
parent b83fd3f8c6
commit 1811d20d2a
+32
View File
@@ -350,6 +350,38 @@ wrangler pages deploy .vercel/output/static --project-name katelyatv
### 🔧 常见问题排除
**🚨 Docker + Kvrocks 登录失败(重要修复)**:
**症状**: 部署成功但登录时提示"账号或密码错误"Kvrocks中admin_config存在但Users数组为空
**原因**: 环境变量配置不完整,缺少USERNAME导致无法创建管理员用户
**解决方案**:
```bash
# 1. 确保 .env 文件包含必要的管理员配置
cat > .env << EOF
USERNAME=admin
PASSWORD=your_secure_password
NEXT_PUBLIC_STORAGE_TYPE=kvrocks
NEXTAUTH_SECRET=your_secret_here
NEXTAUTH_URL=http://localhost:3000
NEXT_PUBLIC_ENABLE_REGISTER=true
EOF
# 2. 重启服务以应用新配置
docker compose -f docker-compose.kvrocks.yml down
docker compose -f docker-compose.kvrocks.yml up -d
# 3. 检查日志确认配置初始化
docker compose logs katelyatv
# 4. 验证Kvrocks中的用户配置
docker exec -it $(docker compose ps -q kvrocks) redis-cli
127.0.0.1:6666> GET admin_config
# 应该看到 Users 数组包含管理员用户
```
**构建失败**
```bash