HiveMQ 4.x：通过config.xml配置UI用户名密码后不生效排查

当前操作与问题 #

• 已在config.xml中添加自定义用户配置：

<control-center>  
  <users>
    <user>
      <name>admin</name>
      <password>7ca94b7c56a07d5a65383a7692f3811a25f6ce67ef648e4ceec750beb1dc43bb</password>
    </user>
  </users>
</control-center>

• 预期登录凭证：用户名admin，密码TestPassword，使用以下命令生成哈希值：

me@yoda:~$ echo -n adminTestPassword | sha256sum
7ca94b7c56a07d5a65383a7692f3811a25f6ce67ef648e4ceec750beb1dc43bb  -

• 问题：重启服务器后，Web UI（端口8080）仍使用默认的admin/hivemq登录

核心问题：哈希生成方式错误 #

根据HiveMQ官方文档中「生成密码哈希」的要求，正确的哈希生成规则是：将用户名和密码用UTF-8编码后，以冒号:分隔拼接，再进行SHA-256哈希计算，而非直接拼接用户名和密码。

你当前的命令是直接拼接adminTestPassword，正确的命令应该是：

echo -n "admin:TestPassword" | sha256sum

用这个命令生成的哈希值替换config.xml中的<password>字段内容。

其他需要检查的点 #

• 确认config.xml的配置位置正确：<control-center>节点必须直接嵌套在<hivemq>根节点下，不能放在其他子节点内部
• 重启HiveMQ时，确保服务进程完全终止后再启动，避免旧配置缓存生效
• 检查config.xml的XML语法：确保所有标签闭合、无语法错误（XML对格式要求严格，语法错误会导致配置不生效）

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