Android端Capacitor加载HTTPS图片返回404问题求助

排查服务器端HTTPS兼容性 #

• 验证证书链完整性：Android系统对SSL证书链的验证比iOS和桌面WebView更严格，若电商店铺域名缺失中间证书，会导致Android无法信任该证书，最终表现为404（实际是证书验证失败被拦截）。可在Android设备自带浏览器中直接打开图片URL，查看是否有证书警告提示。
• 检查TLS版本支持：部分旧版本Android（如7.0及以下）默认不支持TLS 1.3，若电商服务器仅启用TLS 1.3，会导致连接失败。确认服务器是否兼容TLS 1.2及以下版本。

调整Capacitor配置 #

• 配置allowNavigation：在capacitor.config.ts中添加电商域名到允许导航列表，避免Capacitor拦截跨域请求：

  export default defineConfig({
    server: {
      allowNavigation: ['your-shop-domain.com']
    }
  });
  

• 配置Android网络安全策略：创建res/xml/network_security_config.xml文件，明确信任电商域名：

  <?xml version="1.0" encoding="utf-8"?>
  <network-security-config>
    <domain-config cleartextTrafficPermitted="false">
      <domain includeSubdomains="true">your-shop-domain.com</domain>
    </domain-config>
  </network-security-config>
  

  随后在AndroidManifest.xml的<application>标签中关联该配置：

  <application
    ...
    android:networkSecurityConfig="@xml/network_security_config"
    ...>
  

排查WebView行为差异 #

• 测试原生WebView加载：直接在Android原生WebView中加载目标图片URL，若同样返回404，问题出在Android系统或服务器配置；若能正常加载，则排查Capacitor的插件或自定义WebView逻辑是否拦截了请求。
• 检查UA限制：部分CDN会根据用户代理（UA）返回不同内容，Capacitor WebView的UA与浏览器、iOS WebView存在差异。可尝试修改UA模拟其他设备，在MainActivity.java中添加：

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    bridge.getWebView().getSettings().setUserAgentString("Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1");
  }
  

清理缓存 #

• 清除应用缓存：通过Android系统设置清除Capacitor应用的缓存，或调用Capacitor缓存清理API，排除旧缓存导致的404问题。

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