Cordova-Android项目中Web Worker的兼容性问题解析

背景介绍

在Cordova-Android项目开发中，Web Worker是一种常用的技术，它允许开发者在后台线程中执行JavaScript代码，避免阻塞主线程。然而，随着Cordova-Android版本的升级，特别是从12到13版本，开发者发现Web Worker在某些设备上出现了兼容性问题。

问题现象

开发者在使用new Worker('file.worker.js')加载Web Worker时，在Cordova-Android 12版本中运行正常，但在升级到13版本后，部分设备（特别是某些真实用户设备）上会出现资源加载被阻塞的情况。值得注意的是，这个问题在SDK 30/34的模拟器上却表现正常。

根本原因分析

这个问题实际上与Web Worker的同源策略(Same-Origin Policy)有关。当文档使用file://协议加载时，浏览器会将其视为不透明源(opaque origin)。根据规范，从不同不透明源加载的资源会被视为跨源资源，这会导致Web Worker无法正常工作。

在早期版本的Chromium WebView中，可能存在一个bug，允许file://协议下的Web Worker正常工作。但随着WebView的更新（大约在v130版本），这个bug被修复，使得Web Worker在同源策略下的行为符合规范。

解决方案

针对这个问题，推荐以下解决方案：

1. 使用WebViewAssetLoader：通过设置<content src="https://localhost/index.html" />，将应用内容通过内置的Web服务器提供服务，而不是直接使用file://协议。

2. 禁用不安全文件模式：确保配置中AndroidInsecureFileModeEnabled设置为false（这是默认值），这样Cordova会自动使用WebViewAssetLoader。

3. 迁移计划：对于已经使用file://协议的应用，需要制定迁移计划，逐步过渡到使用https://localhost的方式。

技术细节

使用https://localhost作为内容源有几个优势：

• 为文档提供了明确的源(origin)，满足同源策略要求
• 提供了安全上下文(secure context)，支持需要安全上下文的API
• 更符合现代Web安全规范

需要注意的是，这种改变会影响localStorage等存储机制，因为存储是基于源的。这意味着用户的现有数据可能需要迁移处理。

最佳实践建议

1. 在开发初期就避免使用file://协议
2. 定期更新项目依赖，包括Cordova平台和插件
3. 在真实设备上进行充分测试，而不仅依赖模拟器
4. 对于需要持久化的数据，考虑使用兼容性更好的存储方案

总结

Web Worker在Cordova-Android应用中的兼容性问题，本质上是Web安全规范逐步严格化的体现。开发者应当遵循现代Web开发的最佳实践，使用https://localhost代替file://协议，这不仅解决了Web Worker的问题，还能为应用提供更好的安全性和兼容性保障。