使用uni-app开发app时遇到mqtt.js不可用的问题

1 问题背景

基于 Vue3 版本创建了 uni-app 项目用于开发微信小程序，项目中用到了 mqtt.js（v4.1.0），编译为微信小程序能够正常运行，但是编译为 APP 后，控制台打印出如下错误：

TypeError: socketTask.onOpen is not a function

看到 socketTask 后立刻想到了微信小程序，个人以为是 mqtt 连接地址的问题。因为在微信小程序中使用 mqtt.js 时需要将 mqtt 连接地址写为 wx:IP地址:端口号/mqtt，所以把连接地址改为了 ws:IP地址:端口号/mqtt，重新运行后控制台打印出如下错误：

TypeError: WS is not a constructor

经过查看源码（node_modules/mqtt/dist/mqtt.js）发现相关代码如下：

// ... other code ...
var WS = require('ws')// ... other code ... if (isNative && isBrowser) {socket = new WS(target, protocols)
} else {socket = new WS(target, protocols, options)
}

添加 console.log() 语句查看 WS 变量后发现控制台打印结果为 null，即引入第三方库 ws 失败。

直接在 pages/index/index.vue 中引入 ws 库并打印变量，打印结果如下：

// pages/index/index.vue
const WS = require('ws')
console.log(WS)

# 控制台打印结果
function() {throw new Error('ws does not work in the browser. Browser clients must use the native ' + 'WebSocket object');
}

2 引发原因

经查看 ws 库的 Github 主页发现该库仅在 Node.js 环境下运行。结合提示信息，说明 uni-app 在 APP 端的运行环境和浏览器相关。

随后查询官方文档发现：

vue页面在App端，默认是被系统的webview渲染的（不是手机自带浏览器，是rom的webview）。

也就是说 uni-app 在 APP 端的运行环境是 webview，而 ws 库仅在 Node.js 环境下运行，从而导致通过 require() 引入后为 null。

3 解决方法

既然 uni-app 在 APP 端的运行环境是 webview，而微信小程序的运行环境也是 webview，二者运行环境相似，应该可以共用一个创建 WebSocket 连接的 API。而 mqtt.js 在小程序环境中可以正常运行，所以首先将 mqtt 连接地址改回 wx:IP地址:端口号/mqtt，通过小程序 API wx.connectSocket() 创建 WebSocket 连接。

但是问题又回到了一开始，运行后控制台会打印如下错误信息：

TypeError: socketTask.onOpen is not a function

3.1 解决方法1：降低 Vue 版本【推荐⭐】

搜索了很多教程，发现其发布时间多为 2019 ~ 2021，然后想到会不会是 Vue 版本较高导致，尝试降低为 Vue2 版本后重新运行，发现运行成功。

3.2 解决方法2：修改 mqtt.js 源码【推荐⭐⭐⭐⭐⭐】

搜索教程中发现修改源码（node_modules/mqtt/dist/mqtt.js）中的 wx.connectSocket() 也可以解决，解决方法是在调用 wx.connectSocket() 时传入回调函数。

socketTask = wx.connectSocket({url: url,protocols: [websocketSubProtocol],success() {} // 增加这行代码
})

具体原理可见 uni-app 官方API uni.connectSocket()：

对于 uni.connectSocket() API 而言：

如果没有传入 success / fail / complete 参数，则会返回封装后的 Promise 对象；

如果希望返回一个 socketTask 对象，需要至少传入 success / fail / complete 参数中的一个。

所以上面新增的回调函数也可以改为 fail() {} 或 complete() {}。