Flutter构建APK后在其他设备无法调用NodeJS后端API问题排查

1. 网络权限缺失 #

Flutter Debug模式默认会自动配置网络权限，但Release包需要手动配置。打开android/app/src/main/AndroidManifest.xml，确认添加以下权限：

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

如果后端用的是HTTP协议（非HTTPS）且目标设备是Android 9及以上，还需在<application>标签内添加：

android:usesCleartextTraffic="true"

2. API地址错误 #

• 确保打包时使用公网IP/域名，而非本地局域网IP（如192.168.x.x）——其他设备不在同一局域网时无法访问本地IP。
• 检查代码中API地址是否写死，确认Debug和Release环境使用的是同一个正确地址，避免Debug用本地地址、Release未更新。

3. 后端端口/防火墙限制 #

• 确认后端服务器的防火墙已开放API所用端口（如NodeJS默认的3000），云服务器需额外在控制台配置安全组规则，允许外部访问该端口。
• 用其他设备的浏览器/Postman直接访问后端API地址，验证是否能正常响应，排除后端本身的访问障碍。

4. 打包环境配置问题 #

• 若使用环境变量管理API地址，打包时需确保传入正确参数，例如：

flutter build apk --dart-define=BASE_URL=http://你的公网IP:端口

• 清理缓存后重新打包，避免旧配置残留：

flutter clean
flutter build apk

5. HTTPS证书校验问题（若使用HTTPS） #

如果后端用的是自签名SSL证书，Release模式下Flutter会默认拒绝不安全连接。若为测试环境，可在网络请求库（如Dio）中临时忽略证书校验（生产环境请使用正规CA签发的证书）：

import 'dart:io';
import 'package:dio/dio.dart';

Dio dio = Dio();
(dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate = (HttpClient client) {
  client.badCertificateCallback = (X509Certificate cert, String host, int port) => true;
  return client;
};

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