非guest用户持有效凭证无法登录RabbitMQ Web管理控制台求助

我之前在CentOS 7上刚部署完RabbitMQ后，碰到了一个非常头疼的问题：

因为不建议远程使用默认的guest用户登录，我特意创建了一个带有administrator标签的自定义用户（比如日志里的rbt_admn），反复确认用户名和密码都输入正确，但每次登录Web管理控制台都弹出「Login Failed」，查看RabbitMQ日志还能看到这条警告：

2020-02-19 09:56:27.069 [warning] <0.622.0> HTTP access denied: user 'rbt_admn' - invalid credentials

我搜了很多解决方案，大多是针对guest用户无法远程登录或者版本兼容性的问题，完全不适用我的情况，折腾了一整夜才找到根源并解决，现在把方案分享给遇到同样问题的朋友。

问题根源 #

我反复验证凭证后发现，问题出在密码设置的方式上：如果你的密码包含特殊字符（比如@、#、!、$这类），直接在命令行输入密码时会被Shell解析，导致RabbitMQ实际存储的密码和你想要设置的不一致，自然会提示凭证无效。

解决步骤 #

1. 验证凭证有效性（可选但推荐） #

先通过命令行验证你的用户名和密码是否能被RabbitMQ识别，避免白忙活：

rabbitmqctl authenticate_user rbt_admn '你的密码'

如果返回Success，说明凭证没问题；如果返回Failed，那就继续往下走。

2. 重新创建/修改用户密码 #

如果验证失败，你可以选择删除旧用户重新创建，或者直接修改现有用户的密码：

方式一：删除后重新创建

# 删除旧用户
rabbitmqctl delete_user rbt_admn
# 创建新用户，用单引号包裹密码，避免Shell解析特殊字符
rabbitmqctl add_user rbt_admn 'YourSecurePassword@123'
# 设置administrator标签
rabbitmqctl set_user_tags rbt_admn administrator
# 授予默认vhost（/）的全部权限
rabbitmqctl set_permissions -p / rbt_admn ".*" ".*" ".*"

方式二：直接修改现有用户密码

如果你不想删除用户，直接修改密码即可：

rabbitmqctl change_password rbt_admn 'YourSecurePassword@123'

3. 重启RabbitMQ服务 #

最后重启服务让设置生效：

systemctl restart rabbitmq-server

额外注意事项 #

• RabbitMQ的用户名和密码是大小写敏感的，登录时一定要注意输入的大小写是否和设置一致
• 哪怕密码没有特殊字符，也建议用单引号包裹，避免Shell意外解析（比如密码里包含空格或者!这类Shell特殊符号）
• 确保自定义用户已经被授予了对应vhost的权限（默认是/），否则即使凭证正确，也可能无法正常操作，但这种情况日志会提示权限不足，而非凭证无效

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