RabbitMQ HTTP API 无法直接创建可登录用户，必须先用 rabbitmqctl add_user 创建用户并设密码，再通过 PUT /api/users/{name} 设置 tags 和权限；否则即使 API 返回 201，该用户也无法认证登录。
不能直接用 HTTP API 创建用户，必须先用 rabbitmqctl 或管理插件 UI 创建至少一个管理员用户，才能调用 API。 否则会一直返回 401 Unauthorized 或 404 Not Found —— 因为 RabbitMQ 的管理 API 默认不提供“创建用户”这个 endpoint，它只暴露读取和权限变更类接口（如 PUT /api/users/{name} 是修改密码或 tags，不是新建）。
为什么 PUT /api/users/{name} 不是“创建用户”操作
这个 endpoint 实际行为是「upsert」：如果用户已存在，就更新其 password 和 tags；如果不存在，只会创建空用户（无密码、无 tags），且该用户无法登录管理界面或通过 AMQP 认证。RabbitMQ 官方文档明确说明：PUT /api/users/{name} 要求请求体中必须包含 password 字段，但底层仍依赖 Erlang 用户数据库的原子写入逻辑，而空密码在认证链路中会被拒绝。
- 常见错误现象：
curl -X PUT http://localhost:15672/api/users/test -u admin:pass -H "Content-Type: application/json" -d '{"password":"123"}'返回201 Created，但用test/123登录管理页失败，日志报login failed: no_user - 根本原因：RabbitMQ 的 HTTP API 不接管用户存储的初始化流程，它只是对已有用户做属性变更
- 正确路径：必须先用
rabbitmqctl add_user写入用户，再用 API 补充 tags 或改密
批量创建用户的可靠流程（命令行 + API 混合）
真正可落地的自动化脚本分两阶段：先用 rabbitmqctl 批量建用户，再用 API 统一分配 tags 和 vhost 权限。注意 RabbitMQ 节点必须允许远程执行（如容器内需挂载 /var/lib/rabbitmq/.erlang.cookie）。
RabbitMQ 4.2.3 是 2026 年初发布的重要稳定更新版本，重点修复了 Khepri 元数据存储相关问题，并改进了监控性能。对于使用 Docker、Kubernetes 或微服务架构的开发团队来说，该版本兼容性和稳定性表现较好。
- 在宿主机或 Pod 中执行
rabbitmqctl命令前，确认环境变量RABBITMQ_CTL_ERL_ARGS已设为-hidden（避免连接超时） - 批量建用户示例（Bash）：
rabbitmqctl add_user user001 pass001<br>rabbitmqctl add_user user002 pass002<br>rabbitmqctl add_user user003 pass003
- 随后用 API 设置 tags（必须用管理员账号）：
curl -X PUT http://localhost:15672/api/users/user001 -u admin:admin -H "Content-Type: application/json" -d '{"tags":"management"}'<br>curl -X PUT http://localhost:15672/api/users/user002 -u admin:admin -H "Content-Type: application/json" -d '{"tags":"monitoring"}' - 最后设 vhost 权限（关键！否则用户连不上任何 vhost）：
curl -X PUT http://localhost:15672/api/permissions/%2F/user001 -u admin:admin -H "Content-Type: application/json" -d '{"configure":".*","write":".*","read":".*"}'（%2F是 URL 编码后的/）
PowerShell 脚本里调用 API 的坑：404 不是网络问题，是状态未同步
用 PowerShell 批量调用 PUT /api/users/{name} 时出现 404，大概率不是请求发错了，而是 rabbitmqctl add_user 命令刚执行完，Erlang 进程还没把用户数据刷进 Mnesia 数据库，API 层就读不到。这不是幂等性问题，是 RabbitMQ 内部状态同步延迟。
- 不要用
Start-Sleep -Seconds 1硬等，应检查用户是否真实存在：curl -s -u admin:admin http://localhost:15672/api/users | jq -r '.[].name' | Select-String "^user001$"
- PowerShell 中建议用
Invoke-RestMethod并捕获StatusCode，遇到404就重试（最多 3 次，间隔递增） - 若在 Kubernetes 中运行，确保脚本运行在与 RabbitMQ Pod 相同的命名空间，并用
localhost:15672（非 Service DNS），避免 iptables 规则干扰
最易被忽略的一点：所有通过 API 设置的权限（tags、vhost permissions）都只对「已由 rabbitmqctl 创建的用户」生效；反过来，用 API “创建”的用户永远无法用于 AMQP 连接 —— 这个限制不会报错，但会让下游服务静默失败。
