Amazon AWS IoT Core 浏览器端通过WebSocket发送MQTT消息报错如何解决

你遇到的path/fs/tls依赖缺失报错，是因为aws-iot-device-sdk为Node.js环境专属SDK，依赖Node原生模块，不兼容浏览器运行环境。你可以用以下两种方案实现浏览器端的MQTT消息收发： #

方案1：使用官方适配浏览器的IoT SDK v2 #

AWS官方推出的aws-iot-device-sdk-v2已经做了浏览器环境适配，不需要依赖Node原生模块，是首选方案：

• 安装依赖

npm install aws-iot-device-sdk-v2

• 连接与收发消息示例代码：

import { mqtt, io, auth, iot } from 'aws-iot-device-sdk-v2';

// 替换为你自己的配置参数
const CONFIG = {
  iotEndpoint: '你的AWS IoT Core端点地址', // 可在AWS IoT控制台「设置」页面查询
  region: 'AWS区域编码，例如cn-north-1',
  accessKeyId: 'IAM访问密钥ID',
  secretAccessKey: 'IAM秘密访问密钥',
  clientId: `browser-client-${Math.random().toString(36).slice(2, 10)}` // 需保证客户端ID唯一
}

// 初始化连接配置
const clientBootstrap = new io.ClientBootstrap();
const configBuilder = iot.AwsIotMqttConnectionConfigBuilder.new_with_websockets({
  region: CONFIG.region,
  credentials_provider: auth.AwsCredentialsProvider.newStatic(
    CONFIG.accessKeyId,
    CONFIG.secretAccessKey
  )
});
configBuilder.with_client_id(CONFIG.clientId);
configBuilder.with_endpoint(CONFIG.iotEndpoint);
const clientConfig = configBuilder.build();

// 创建MQTT客户端实例
const client = new mqtt.MqttClient(clientBootstrap).new_connection(clientConfig);

// 监听连接成功事件
client.on('connect', async (sessionPresent) => {
  console.log('IoT Core连接成功：', sessionPresent);
  // 订阅主题
  await client.subscribe('test/topic', mqtt.QoS.AtLeastOnce);
  // 发布消息
  await client.publish(
    'test/topic',
    JSON.stringify({ content: '来自浏览器的测试消息' }),
    mqtt.QoS.AtLeastOnce
  );
});

// 监听接收消息
client.on('message', (topic, payload) => {
  const msg = new TextDecoder('utf8').decode(payload);
  console.log(`收到主题【${topic}】的消息：`, msg);
});

// 发起连接
client.connect();

方案2：使用通用MQTT库手动签名连接 #

如果你不想引入AWS专属SDK，也可以用通用mqtt库，配合AWS Signature V4签名生成WebSocket连接URL后对接：

• 安装依赖

npm install mqtt @aws-sdk/signature-v4 @aws-crypto/sha256-js

核心逻辑是通过签名算法生成带认证信息的WebSocket连接地址，再用mqtt.js直接连接即可。 #

注意事项 #

• 安全优先：禁止在前端代码中硬编码永久IAM密钥，建议后端提供STS临时凭证接口，前端每次连接前获取短时效的临时凭证，避免密钥泄露风险
• 权限配置：确保对应IAM身份绑定的IoT策略已经开放iot:Connect、iot:Publish、iot:Subscribe、iot:Receive对应主题的操作权限
• 端点确认：AWS中国区和国际区的IoT Core端点格式不同，需在控制台确认后再配置

#

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