如何在iOS端通过Codename One解决字节数组与SQLite兼容问题

一、未加密数据库：图片无法存入iOS的解决步骤 #

• 改用PreparedStatement绑定BLOB参数
  直接用db.execute传byte[]参数在iOS上可能存在参数绑定逻辑差异，换用预编译语句明确绑定字节数组：

  // 替换原插入代码
  String insertSql = "INSERT INTO pictures (image) VALUES (?)";
  PreparedStatement pstmt = db.prepareStatement(insertSql);
  pstmt.setBytes(1, imageData);
  pstmt.executeUpdate();
  pstmt.close();
  

• 验证图片数据有效性
  在iOS端打印imageData.length，对比Android端的数值，确认EncodedImage.getImageData()在iOS上生成的字节数组完整且有效。如果长度为0或异常，检查图片加载逻辑（比如iOS上WebP等特殊格式是否需要额外处理）。
• 调整SQLite页大小（针对大图片）
  iOS系统自带SQLite版本可能对大BLOB支持有限，若图片超过10MB，可在创建数据库时执行：

  PRAGMA page_size = 4096; -- 或更大值，需在首次创建数据库时设置
  

二、加密数据库：抛出java.io.IOException: SQL error in step. Code: 10的解决步骤 #

Code10对应SQLite的SQLITE_IOERR（IO错误），核心是FilesCipher的跨平台适配问题：

• 统一加密算法参数
  确保iOS与Android端加密逻辑完全一致：
  • 加密算法：必须相同（如AES-256）
  • 加密模式：CBC/ECB需统一（推荐CBC模式）
  • 填充方式：Android的PKCS5Padding等价于iOS的PKCS7Padding，需对应使用
  • IV向量：加密解密必须使用相同的IV，且IV的生成、存储逻辑跨平台统一
• 修正数据库路径处理
  iOS应用沙盒路径与Android完全不同，FilesCipher必须使用iOS合法存储路径，禁止硬编码：

  // 跨平台获取数据库路径示例
  String dbPath;
  if (Platform.isAndroid()) {
      dbPath = getContext().getFilesDir().getPath() + "/mydb.db";
  } else if (Platform.isIOS()) {
      dbPath = FileSystemStorage.getInstance().getAppHomePath() + "/mydb.db";
  }
  

• 关闭WAL日志模式
  iOS上SQLite默认启用WAL模式，部分加密方案与WAL兼容性差，打开数据库前执行：

  PRAGMA journal_mode = DELETE;
  

• 检查VFS注册逻辑
  若FilesCipher通过替换SQLite VFS实现加密，需确保在iOS上正确注册自定义VFS，且VFS的文件读写逻辑适配iOS沙盒权限要求。

通用排查技巧 #

• 开启SQLite调试日志：在iOS端启用SQLite日志，查看Code10对应的具体IO错误详情（如文件权限、文件损坏）。
• 测试最小用例：先插入new byte[]{1,2,3}这类小字节数组验证存储逻辑，再逐步替换为真实图片数据。
• 验证加密数据库完整性：将Android上加密后的数据库拷贝到iOS设备，尝试直接读取，确认加密逻辑的跨平台一致性。

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