Flutter骑行App连接Node.js服务报TLS握手版本错误如何排查

• 优先检查网络权限配置
  对比两个应用的清单文件可直接发现，正常运行的门店端配置了<uses-permission android:name="android.permission.INTERNET" />，但骑行端的清单文件缺失该权限，这是最可能的直接诱因，补全该权限后先验证是否恢复正常。
• 校验URI构造逻辑与环境变量值
  确认Environment.dbUrl的取值是否仅包含IP+端口（例如192.168.1.2:3000），没有额外携带http:///https://协议头：如果dbUrl带了协议头，用Uri.http/Uri.https构造时会生成非法URI；同时确认服务端监听的当前端口对应的协议和你URI构造用的协议一致，比如用HTTP请求HTTPS端口时，服务端返回的TLS握手包会被客户端识别为版本不匹配，直接触发该报错。
• 检查应用TargetSDK版本差异
  如果两个应用的build.gradle中targetSdkVersion配置不同：门店端targetSdk≤27（Android 8.1）默认允许明文流量，骑行端targetSdk≥28（Android 9）默认禁止明文流量，此时即使不配置android:usesCleartextTraffic="true"，低版本target的应用也能正常发起HTTP请求，高版本的骑行端就会被拦截。可以临时在骑行端的application标签中添加android:usesCleartextTraffic="true"验证是否是该问题。
• 核对HTTP依赖库的版本与配置
  确认两个应用依赖的http包版本是否一致，低版本的http包可能存在TLS适配bug；同时检查骑行端是否有全局配置自定义HTTP客户端、证书校验规则、TLS版本限制，这类配置会导致和服务端TLS握手不兼容。
• 检查自定义网络安全配置
  如果骑行端配置了自定义network_security_config.xml，需要确认是否限制了域名、TLS版本或者明文流量权限，额外的限制规则可能导致请求被拦截。
• 排除本地代理/调试工具干扰
  确认骑行端是否开启了代理、抓包工具等配置，这类工具如果没有正确安装证书，会篡改TLS握手流程触发版本不匹配错误。

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