Cordova Android项目中的ERR_CONNECTION_REFUSED错误分析与解决方案

问题现象

在Cordova Android项目中，开发者遇到一个典型的应用启动错误。在开发环境下使用模拟器时运行正常，但当发布到生产环境后，应用启动时会出现以下错误提示：

Application Error
net::ERR_CONNECTION_REFUSED
(https://localhost/index.html)

问题分析

这个错误表明应用在生产环境中无法正确加载本地资源。深入分析后，我们发现这涉及到Cordova Android平台的核心工作机制：

1. 资源加载机制：现代Cordova Android应用默认使用WebViewAssetLoader来加载本地资源，通过模拟的https://localhost地址提供服务，而不是传统的file://协议。

2. 配置影响：开发者尝试通过config.xml中的各种配置来解决此问题，包括：

   • 添加allow-intent规则
   • 设置access origin为*
   • 配置hostname为localhost
   • 启用了AndroidInsecureFileModeEnabled

3. 构建过程差异：项目使用了vue-cli-plugin-cordova插件，构建命令的选择对最终结果有重要影响。

根本原因

经过排查，问题主要由以下因素导致：

1. 不恰当的AndroidInsecureFileModeEnabled设置：这个选项强制应用使用file://协议加载资源，与现代Cordova Android的默认机制冲突。

2. 构建命令不规范：在Vue+Cordova混合项目中，直接使用cordova build命令而忽略了vue-cli-plugin-cordova提供的专用构建脚本，导致构建过程不完整。

解决方案

1. 修正config.xml配置

移除或避免使用AndroidInsecureFileModeEnabled选项，保持现代Cordova的默认资源加载机制：

<!-- 不建议使用 -->
<preference name="AndroidInsecureFileModeEnabled" value="true" />

同时，确保scheme和hostname的正确配置：

<platform name="android">
    <preference name="scheme" value="https" />
    <preference name="hostname" value="localhost" />
</platform>

2. 使用正确的构建命令

在Vue+Cordova混合项目中，应使用插件提供的专用构建命令：

npm run cordova-build-android

而不是直接使用Cordova CLI的构建命令：

cordova build android --release

3. 平台版本检查

确保使用最新的Cordova Android平台版本（当前推荐13.0.0+），可通过以下命令检查和更新：

cordova platform ls
cordova platform remove android
cordova platform add android@13

最佳实践建议

1. 避免使用file://协议：现代Cordova应用应使用WebViewAssetLoader机制，它提供了更好的安全性和兼容性。

2. 混合框架注意事项：当使用Vue、React等框架与Cordova结合时，务必遵循框架插件的构建流程，不要绕过专用构建脚本。

3. 配置规范化：

   • 将android特定配置放在标签内
   • 移除已废弃的配置如AndroidXEnabled
   • 确保targetSdkVersion与最新要求一致

4. 测试策略：在发布前，使用cordova run android --release命令测试release构建，而不必每次都发布到应用商店。

总结

Cordova Android项目中的ERR_CONNECTION_REFUSED错误通常与资源加载机制和构建过程相关。通过理解Cordova Android平台的工作原理，正确配置config.xml，并使用适当的构建命令，可以有效解决这类问题。特别是在混合框架项目中，遵循框架特定的构建流程至关重要。保持Cordova平台和插件的更新也是预防此类问题的有效方法。