Mac本地安装MiniKF时用户配置阶段失败的解决咨询

我之前在Mac上部署MiniKF的时候也碰到过几乎一模一样的问题，给你几个亲测有效的排查和解决步骤：

1. 优先核对默认登录凭据 #

这是最常见的坑！MiniKF的默认登录组合并不是你可能以为的user+简单密码，正确的默认凭据是：

• 用户名：user@example.com（必须是完整的邮箱格式，不能只输user）
• 密码：12341234

我当初就是犯了只输入user的错误，导致一直弹出"Invalid Email Address and password"和后台的401错误，换成完整邮箱后直接就登录成功了。

2. 重启Vagrant虚拟机修复网络/服务异常 #

MiniKF运行在Vagrant虚拟机中，有时候虚拟机的网络初始化不彻底，或者部分服务启动失败会导致认证请求异常。可以尝试重启虚拟机：

# 切换到你的MiniKF本地安装目录，执行以下命令
vagrant halt
vagrant up

重启完成后，重新访问http://10.10.10.10走向导流程，很多时候这类临时的服务异常会被解决。

3. 查看provision.log日志定位深层问题 #

错误提示中提到的/home/vagrant/provision.log包含了完整的部署日志，可以通过Vagrant登录到虚拟机查看细节：

# 本地执行，登录到虚拟机
vagrant ssh
# 查看日志文件
cat /home/vagrant/provision.log

重点关注和rok-gw、认证服务相关的日志条目，比如是否有服务启动失败、数据库初始化错误等信息。如果发现是rok-gw服务异常，可以手动重启它：

# 在虚拟机内执行
sudo systemctl restart rok-gw

4. 重置MiniKF环境（终极方案） #

如果上面的方法都无法解决问题，可以尝试彻底重置MiniKF环境，从头开始部署：

# 本地安装目录下执行，销毁现有虚拟机
vagrant destroy -f
# 重新启动MiniKF部署流程
./minikf start

注意：这个操作会清除所有已有的MiniKF配置和数据，执行前请确认没有需要保留的内容。

内容的提问来源于stack exchange，提问作者ofirbt