Flutter发布版APK中MQTT功能失效，调试版正常问题求助

• 检查ProGuard/R8混淆规则
  发布版默认启用代码混淆，MQTT相关类被混淆后会导致逻辑失效。在android/app/proguard-rules.pro中添加对应库的混淆保留规则：

# 根据你使用的MQTT客户端库调整包名
-keep class org.eclipse.paho.** { *; }
-keep class com.hivemq.client.** { *; }
# 若使用mqtt_client库，添加：
# -keep class io.flutter.plugins.mqtt.** { *; }

• 配置网络安全策略（Android 9+）
  Android 9及以上默认禁止明文HTTP/TC流量，若你的MQTT broker使用tcp://协议，需创建网络安全配置文件：
  在android/app/src/main/res/xml/network_security_config.xml中写入：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

并在AndroidManifest.xml的<application>标签中引用：

android:networkSecurityConfig="@xml/network_security_config"

• 确认权限配置位置
  确保INTERNET权限放在<manifest>标签下、<application>标签外，同时可添加网络状态权限辅助排查：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.your.package.name">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <application ...>
        ...
    </application>
</manifest>

• 核对MQTT客户端配置
  排查调试版与发布版的配置差异：

  • 确认发布版使用的broker地址、端口、认证信息正确，未误用调试环境地址
  • 检查客户端ID是否唯一，避免因ID重复被broker拒绝连接
  • 若使用SSL连接，确认发布版信任对应证书，未遗漏调试时的证书忽略逻辑

• 抓取发布版日志定位问题
  通过adb获取应用日志，明确连接失败的具体原因：

adb logcat -s Flutter:V Mqtt:V

替换日志标签为你应用中MQTT相关的标识，查看是否有连接超时、认证失败、协议错误等具体报错

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