Apache DolphinScheduler管理员密码异常问题分析与解决方案

问题现象

在使用Docker Compose部署Apache DolphinScheduler后，管理员账户admin的密码突然无法正常登录。该问题在启用access token功能后出现，系统日志显示"Username or password entered incorrectly"错误，但实际上密码是正确的。

问题分析

通过排查发现，当修改DolphinScheduler API容器的配置文件并启用gateway功能后，重启容器会导致密码验证异常。这表明系统在特定配置下存在密码验证机制的兼容性问题。

临时解决方案

对于已经出现该问题的环境，可以通过以下步骤重置管理员密码：

1. 进入PostgreSQL容器：

docker exec -it docker-dolphinscheduler-postgresql-1 /bin/bash

2. 登录DolphinScheduler数据库：

psql -Uroot -d dolphinscheduler

3. 生成新密码的MD5加密字符串（以"Aa123456#"为例）：

echo -n "Aa123456#" | md5

4. 更新数据库中的密码：

update t_ds_user set user_password='c96da3623f1434248c7ee7f0be47a51d' where user_name='admin';

根本原因

该问题可能与以下因素有关：

1. 密码加密机制在特定配置下的不一致性
2. Gateway功能启用后对认证流程的影响
3. 容器重启后配置加载顺序问题

预防措施

为避免类似问题发生，建议：

1. 在修改重要配置前备份数据库
2. 记录初始管理员密码
3. 考虑使用外部用户管理系统集成

总结

Apache DolphinScheduler在特定配置下可能出现密码验证异常问题，通过直接修改数据库可以快速恢复访问权限。开发团队应关注该问题的根本原因，未来版本中修复这一兼容性问题。对于生产环境，建议在修改关键配置前进行全面测试。