Capacitor无法打开资源URL问题求助（附配置及日志）

问题场景 #

开发Capacitor Android应用时，出现资源加载失败错误，核心日志如下：

E/Capacitor: Unable to open asset URL: https://example.com/assets/ha-logo-favicon.png

当前capacitor.config.json配置：

{  
  "appId": "com.example.android",  
  "appName": "example",  
  "webDir": "dist",  
  "bundledWebRuntime": false,  
  "server": {    
    "hostname": "example.com",    
    "androidScheme": "https"  
  }
}

完整日志显示多个https://example.com/assets/路径下的图片资源均无法正常访问。

排查与解决步骤 #

1. 确认本地资源的完整性与路径正确性 #

• 检查dist/assets目录下是否存在对应图片文件（如ha-logo-favicon.png），确保打包构建时资源被正确同步到webDir指定的目录中。
• 注意Android文件系统区分大小写，代码中引用的文件名需与实际文件的大小写完全匹配。

2. 调整Capacitor服务器配置 #

当前server.hostname的自定义域名可能导致本地资源映射异常，可尝试以下调整：

• 移除server.hostname配置，使用默认本地路径访问：

  "server": {
    "androidScheme": "https"
  }
  

• 若需保留自定义hostname，添加allowNavigation明确允许该域名的本地访问：

  "server": {
    "hostname": "example.com",
    "androidScheme": "https",
    "allowNavigation": ["example.com"]
  }
  

3. 检查Android项目配置 #

• 确保AndroidManifest.xml中添加了必要权限：

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

• 若需要自定义WebView行为，可在MainActivity.java中添加资源访问允许逻辑：

  import com.getcapacitor.BridgeWebViewClient;
  import com.getcapacitor.WebView;
  
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    registerPlugin(MyPlugin.class);
  
    getBridge().setWebViewClient(new BridgeWebViewClient(getBridge()) {
      @Override
      public boolean shouldOverrideUrlLoading(WebView view, String url) {
        if (url.startsWith("https://example.com/assets/")) {
          view.loadUrl(url);
          return true;
        }
        return super.shouldOverrideUrlLoading(view, url);
      }
    });
  }
  

4. 清理并重新构建项目 #

• 清理Android构建缓存：在Android项目目录执行./gradlew clean
• 同步Capacitor配置：执行npx cap sync android
• 重新运行应用：执行npx cap run android

5. 验证资源本身的可访问性 #

• 在本地开发环境中，直接通过浏览器访问dist/assets下的资源（如http://localhost:端口/assets/ha-logo-favicon.png），确认资源本身无损坏、路径可正常访问。

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