emqx/MQTTX

MQTTX 连接 OneNET 云平台反复提示 Bad username or password 问题

Open

#2,048 opened on May 19, 2026

View on GitHub
 (0 comments) (0 reactions) (0 assignees)TypeScript (544 forks)auto 404
help wanted

Repository metrics

Stars
 (5,003 stars)
PR merge metrics
 (PR metrics pending)

Description

Describe the problem you Confuse

在 MQTTX 客户端中模拟设备连接 OneNET 云平台时，反复出现 Error: Connection refused: Bad username or password 错误。已多次核对并确认 Client ID、Username 以及使用平台官方工具生成的 Password（Token）完全正确，但仍然无法连接成功。尝试过切换服务器地址、更换端口、调整 SSL/TLS 设置，并严格按照文档重新生成 Token，问题依然存在。困惑的点在于：既然账号密码没有错，为什么还会被拒绝？

More detail

  • MQTT 版本：3.1.1
  • 服务器地址：studio-mqtt.heclouds.com，端口：1883
  • Client ID 格式：产品ID&设备名称
  • Username：产品ID
  • Password：通过 OneNET 平台“设备调试”在线工具生成的 Token（method=md5，res=products/.../devices/...，et=1810609920）
  • 已在平台确认设备状态为“已注册”且未被禁用
  • SSL/TLS 已设置为关闭
  • 生成 Token 时使用的是“设备密钥 (deviceKey)”，已检查所有字段无多余空格
  • 网络环境正常，可访问外部 MQTT 服务

Contributor guide

Research direction
Inspect MQTTX's MQTT connection logic, specifically how the password (token) is transmitted. Compare with OneNET's required token format (e.g., URL encoding, ASCII encoding). Check if the token string contains any hidden characters or if the MQTT library (e.g., mqtt.js) expects a buffer vs string.
Tech stack
typescript
Domain
backend
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
MQTT basics
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70