Nuxt集成AWS IoT Device SDK报错：filesys.existsSync不是函数

这个报错的核心原因很明确：aws-iot-device-sdk是为Node.js环境设计的，它依赖Node.js的fs文件系统模块读取本地证书文件，但Nuxt在客户端渲染时运行在浏览器环境中，浏览器没有fs模块，所以会抛出这个错误。

下面给你几个针对性的解决方案，你可以根据自身使用场景选择：

方案一：仅在服务端加载插件（最简单，适合服务端IoT交互场景） #

如果你的IoT交互逻辑只需要在服务端执行，只需要让这个插件仅在Nuxt的服务端环境运行即可：

1. 修改插件配置，在nuxt.config.js中给这个插件指定mode: 'server'：

export default {
  plugins: [
    { src: '~/plugins/aws-iot.js', mode: 'server' }
  ]
}

这样插件只会在Nuxt服务端初始化，客户端不会执行这段代码，自然就不会触发fs相关的错误。服务端是Node.js环境，完全可以正常读取证书文件并初始化AWS IoT设备连接。

方案二：改用浏览器兼容的方式实现客户端IoT连接（适合客户端直接交互场景） #

如果需要在浏览器端直接连接AWS IoT，aws-iot-device-sdk并不适用，你需要换用浏览器友好的方案：

方式1：使用AWS SDK for JavaScript v3的IoTDataPlane #

这个SDK支持浏览器环境，推荐通过AWS Cognito身份池认证，无需依赖本地证书文件：

// 在客户端插件或页面中引入
import { IoTDataPlaneClient, PublishCommand } from "@aws-sdk/client-iot-data-plane";
import { fromCognitoIdentityPool } from "@aws-sdk/credential-provider-cognito-identity";

const client = new IoTDataPlaneClient({
  region: "你的AWS区域",
  credentials: fromCognitoIdentityPool({
    clientConfig: { region: "你的AWS区域" },
    identityPoolId: "你的Cognito身份池ID",
  }),
  endpoint: "你的AWS IoT端点（如xxx.amazonaws.com）",
});

// 示例：发布消息到IoT主题
const publishCommand = new PublishCommand({
  topic: "你的主题名称",
  payload: JSON.stringify({ message: "Hello from Nuxt client" }),
});

client.send(publishCommand)
  .then(response => console.log("消息发布成功", response))
  .catch(err => console.error("发布失败", err));

方式2：嵌入证书内容并使用WebSocket连接 #

如果坚持使用证书认证，可以把证书、密钥、CA的内容直接以字符串形式嵌入代码（注意不要把敏感信息提交到版本库），然后通过WebSocket方式连接：

// 注意：仅在信任的环境中使用，避免证书泄露
const clientId = "你的客户端ID";
const endpoint = "你的AWS IoT端点";
const caCert = "-----BEGIN CERTIFICATE-----\n你的CA证书内容\n-----END CERTIFICATE-----";
const clientCert = "-----BEGIN CERTIFICATE-----\n你的客户端证书内容\n-----END CERTIFICATE-----";
const privateKey = "-----BEGIN RSA PRIVATE KEY-----\n你的私钥内容\n-----END RSA PRIVATE KEY-----";

// 使用aws-iot-device-sdk-js-v2的浏览器版本
import { mqtt } from 'aws-iot-device-sdk-v2';

const config = {
  host_name: endpoint,
  client_id: clientId,
  tls_ctx: {
    ca: caCert,
    cert: clientCert,
    key: privateKey,
  },
};

const client = mqtt.new_client(config);
client.on('connect', () => {
  console.log('连接到AWS IoT成功');
  client.subscribe('你的主题名称');
});

方案三：通过服务端API中转IoT请求（兼顾安全和兼容性） #

如果不想在客户端处理认证和IoT连接逻辑，可以在Nuxt中创建一个服务端API，所有客户端的IoT请求都通过这个API中转，由服务端负责和AWS IoT交互：

1. 创建server/api/iot-publish.js：

import awsIot from 'aws-iot-device-sdk';

// 初始化设备连接（仅在服务端运行）
const device = awsIot.device({
  keyPath: 'xxxxxx',
  certPath: 'xxxxxx',
  caPath: 'xxxxxx',
  clientId: 'xxxxx',
  region: 'xxxxxx',
  host: 'xxxxxxxxxx.amazonaws.com'
});

export default defineEventHandler(async (event) => {
  const { topic, payload } = await readBody(event);
  
  return new Promise((resolve, reject) => {
    device.publish(topic, JSON.stringify(payload), (err) => {
      if (err) reject(err);
      else resolve({ success: true });
    });
  });
});

2. 客户端调用这个API：

// 在页面或组件中
const publishToIoT = async (topic, payload) => {
  const response = await fetch('/api/iot-publish', {
    method: 'POST',
    body: JSON.stringify({ topic, payload }),
    headers: { 'Content-Type': 'application/json' }
  });
  return response.json();
};

// 使用示例
publishToIoT('my/topic', { data: 'test' })
  .then(res => console.log('发布成功', res))
  .catch(err => console.error('发布失败', err));

这种方式既避免了客户端环境的兼容性问题，也能更好地保护你的IoT证书等敏感信息。

内容的提问来源于stack exchange，提问作者Zéca