From 1811d20d2adbc0d1cb1e5cacb04552cf91fbeb4f Mon Sep 17 00:00:00 2001
From: katelya <katelya77@gmail.com>
Date: Thu, 4 Sep 2025 23:42:46 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0Docker+Kvrocks?=
 =?UTF-8?q?=E7=99=BB=E5=BD=95=E5=A4=B1=E8=B4=A5=E9=97=AE=E9=A2=98=E7=9A=84?=
 =?UTF-8?q?=E8=AF=A6=E7=BB=86=E6=95=85=E9=9A=9C=E6=8E=92=E9=99=A4=E6=8C=87?=
 =?UTF-8?q?=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

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

 技术改进:
- 明确标识这是重要修复项
- 提供可复制执行的命令脚本
- 添加配置验证步骤确保修复生效
---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/README.md b/README.md
index 36f33f3..36dac4e 100644
--- a/README.md
+++ b/README.md
@@ -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