Android使用HiveMQ实现MQTT通信报Failed to open a socket错误

报错java.net.SocketException: Operation not permitted的核心原因是应用缺少Android系统要求的网络访问权限，属于平台权限配置缺失问题。除此之外你的现有代码还存在3处会导致后续运行失败的隐患，需要一并修复。

1. 补充网络权限声明 #

打开应用模块下的AndroidManifest.xml，在<manifest>标签层级、<application>标签之前添加以下权限配置：

<!-- 基础网络访问权限，必须添加 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 可选，用于检测网络状态 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

INTERNET属于普通安装时权限，不需要动态申请，应用安装后系统会自动授予。

2. 把网络操作移出主线程 #

你当前在按钮点击回调（UI主线程）中直接调用阻塞式MQTT连接、发布方法，会触发Android的NetworkOnMainThreadException。Android严格禁止在主线程执行网络等耗时操作，避免界面卡顿无响应。
你可以选择两种方式修复：

• 把阻塞客户端的逻辑放到独立子线程中执行
• 替换为HiveMQ提供的Mqtt3AsyncClient异步客户端，通过回调处理连接、发布结果，不会阻塞主线程

3. 补全HiveMQ Cloud连接必填参数 #

你使用的HiveMQ Cloud 8883端口是TLS加密端口，服务端强制要求用户名密码认证，同时客户端必须传入全局唯一的客户端ID，否则即使网络连通也会被服务端拒绝连接。修正后的客户端构建与连接代码参考：

Mqtt3BlockingClient client = MqttClient.builder()
        .useMqttVersion3()
        .identifier(UUID.randomUUID().toString()) // 生成唯一客户端ID
        .serverHost(host)
        .serverPort(8883)
        .sslWithDefaultConfig()
        .buildBlocking();

// 替换为你在HiveMQ Cloud控制台配置的访问凭证
client.connectWith()
        .simpleAuth()
        .username("你的HiveMQ实例用户名")
        .password("你的HiveMQ实例访问密码".getBytes(UTF_8))
        .applySimpleAuth()
        .send();

4. 验证网络连通性 #

确认测试设备/模拟器可以正常访问公网，本地网络、防火墙没有拦截8883端口的出站请求。

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