### 关于 Capacitor 打包的安卓 App 中 FormData 上传数据为空的问题分析与解决方案 在使用 Capacitor 构建 Android 应用时，可能会遇到通过 `FormData` 提交的数据在到达服务器端后变成空的情况。这种问题通常是由于以下几个方面引起的。 #### 1. Content-Type 的自动设置 当使用 `fetch` 或者 `XMLHttpRequest` 发送带有 `FormData` 的请求时，浏览器会自动将 `Content-Type` 设置为 `multipart/form-data` 并附带边界信息（boundary）。然而，在某些情况下，Capacitor Webview 可能不会正确处理这些头部信息[^1]。因此，建议显式禁用手动设置 `Content-Type`，让浏览器自行管理。 ```javascript fetch('https://example.com/upload', { method: 'POST', body: formData, // 不要手动指定 headers['Content-Type'] }).then(response => response.json()).catch(error => console.error(error)); ``` #### 2. HTTPS 清文传输限制 (Cleartext Traffic) 如果目标 URL 使用的是 HTTP 而非 HTTPS，那么 Android 默认不允许 cleartext traffic（即未加密通信），这可能导致请求失败或被拦截。尽管这不是直接导致 `FormData` 数据丢失的原因，但它确实会影响整个请求的成功率。可以在项目的 `capacitor.config.json` 文件中调整 `androidScheme` 参数来临时规避该问题： ```json { "appId": "com.example.app", "appName": "ExampleApp", "bundledWebRuntime": false, "npmClient": "npm", "webDir": "www", "server": { "cleartext": true, "androidScheme": "http" } } ``` 随后运行命令重新同步配置： ```bash npx cap sync android && npx cap open android ``` 更推荐的做法是在 AndroidManifest.xml 文件里明确声明支持明文流量： ```xml <application ... android:usesCleartextTraffic="true"> </application> ``` #### 3. 插件冲突或权限不足 有时第三方插件如 File Transfer[@ionic-native/file-transfer][^4]的存在也可能干扰正常的网络行为；另外还需要确认应用已经获得了必要的存储读写权限以便能够访问本地文件资源。可通过以下方式增加相应权限申请代码片段至 MainActivity.java : ```java import android.Manifest; import com.getcapacitor.PluginRegistry; public class MainActivity extends BridgeActivity { @Override public void onCreate(Bundle savedInstanceState){ super.onCreate(savedInstanceState); // Register plugins here PluginRegistry registry = this.getPluginRegistry(); String[] perms = { Manifest.permission.READ_EXTERNAL_STORAGE }; requestPermissions(perms ,1 ); } private void requestPermissions(String[] permissions,int requestCode ){ this.requestPermissions(permissions,requestCode); } } ``` #### 4. 编译工具链版本匹配不当 确保所使用的 Gradle 版本、Android SDK Build Tools 版本以及 Target API Level 符合官方文档指导标准[^5]。不恰当的选择容易引发各种难以预料的技术难题，包括但不限于上述提到的现象。 --- ### 总结 综上所述，解决 Capacitor 安卓 APP 中 Form Data Upload Empty Issue 主要有四个方向入手：一是避免人为干预 content-type header;二是妥善应对 Cleartext Transmission Policy ;三是排除潜在 Plugin Conflicts And Insufficient Permissions Factors;四是严格遵循 Correct Compilation Toolchain Versions Selection Guidelines. ---