Android设备上PouchDB putAttachment无返回问题排查（疑因系统更新）

问题概述 #

近期未对Ionic/Angular应用做任何代码修改，但部分Android设备调用PouchDB的putAttachment方法时出现无返回、无异常抛出的情况。已升级至最新版PouchDB及cordova-plugin-sqlite-2适配器，问题仍未解决：

• 使用Blob类型添加image/jpeg附件时，无论是单独调用putAttachment，还是将附件内嵌到文档中调用post，均无响应；
• 改用base64编码字符串添加附件时，本地操作可正常完成，但同步到CouchDB时疑似出现409冲突。
  怀疑问题与7月底Android系统的批量更新有关。

排查步骤 #

1. 启用PouchDB调试日志定位卡点 #

初始化PouchDB实例时开启全量调试日志，重点跟踪附件处理和SQLite适配器的执行流程：

PouchDB.debug.enable('*');

查看日志中pouchdb:adapter:cordova-sqlite和pouchdb:attachment相关输出，确认是Blob转换阶段、SQLite写入阶段还是其他环节出现阻塞。

2. 验证Android存储权限与适配 #

• 针对Android 10及以下设备，确认应用已申请READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限；Android 11+需检查分区存储适配，可临时在AndroidManifest.xml中开启旧存储模式验证：

  <application android:requestLegacyExternalStorage="true">
  

• 手动检查设备剩余存储空间，以及应用是否被系统限制存储访问权限。

3. 单独测试SQLite适配器的Blob处理能力 #

跳过PouchDB，直接使用cordova-plugin-sqlite-2测试Blob存储，验证适配器本身的兼容性：

window.sqlitePlugin.openDatabase({name: 'test_blob.db'}, function(db) {
  db.executeSql('CREATE TABLE IF NOT EXISTS test_blobs (id TEXT PRIMARY KEY, blob_data BLOB)', [], function() {
    const testBlob = new Blob(['sample image data'], {type: 'image/jpeg'});
    db.executeSql('INSERT INTO test_blobs VALUES (?, ?)', ['test_id', testBlob], 
      (res) => console.log('Blob存储成功'),
      (err) => console.error('Blob存储失败:', err)
    );
  }, (err) => console.error('创建表失败:', err));
});

如果此测试出现异常，说明问题出在SQLite适配器与Android系统的兼容性上，而非PouchDB上层逻辑。

4. 对比不同Android版本的表现 #

• 统计出现问题的设备的Android版本，重点排查7月底更新覆盖的版本（如Android 13/14的补丁包）；
• 使用Android模拟器安装对应版本的系统，复现问题，确认是否与特定系统版本强相关。

5. 排查同步时的409冲突原因 #

• 启用CouchDB的调试日志，查看同步请求的详细响应，确认冲突是文档版本不匹配，还是base64附件的格式/大小触发了服务器端校验；
• 尝试分步操作：先创建无附件的文档并同步到服务器，再调用putAttachment添加base64附件，再次同步，看是否能避免冲突。

同类问题参考 #

近期社区有开发者反馈，Android 14部分补丁更新后，cordova-plugin-sqlite-2处理Blob时出现阻塞，原因是系统对文件IO的权限校验逻辑变更。部分用户通过将适配器回退到3.0.0版本（而非最新版）临时解决了Blob无响应问题，可尝试回退版本验证。

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