Worklight 7.1 JsonStore集成SQLCipher在Win8.1混合项目报PERSISTENT_STORE_FAILURE

我之前在Windows环境开发Worklight混合应用时，也碰到过几乎一模一样的PERSISTENT_STORE_FAILURE问题，当时折腾了好一阵才找到原因，分享几个我亲测有效的排查方向：

• 确认sqlite3.dll的加密兼容性：
  普通的SQLite DLL是不支持密码加密的，你替换的dll必须是带加密扩展的版本（比如基于SQLCipher编译的）。另外要注意dll的位数（32位/64位）必须和你的Worklight应用及Windows系统匹配，否则加载时会静默失败，触发存储错误。可以确认Worklight文档推荐的SQLite加密dll版本，或者使用官方编译的SQLCipher包。

• 验证DLL的加载路径是否正确：
  有时候系统会优先加载系统目录里的默认sqlite3.dll，而不是你替换的那个。可以用Windows的Process Monitor工具，过滤你的应用进程，查看它实际加载的sqlite3.dll路径，确认是不是你放在项目native目录下的那个文件。如果路径不对，要么调整应用的DLL搜索优先级，要么确保你的dll在应用能优先找到的位置。

• 排查密码初始化代码的正确性：
  先做简化测试：暂时去掉密码参数，调用WL.JSONStore.initCollections()初始化数据库，如果能正常工作，说明问题出在加密逻辑上。再检查密码是否包含特殊字符（比如非ASCII字符），Worklight的加密API对密码的编码有没有要求，比如是否需要转码为UTF-8？另外确认API调用的参数格式是否正确，比如配置对象里的password字段有没有拼写错误。

• 开启Worklight原生层详细日志：
  Worklight的Windows原生组件支持更详细的日志输出，你可以在项目的native/windows/Properties/AssemblyInfo.cs里添加日志配置，或者在应用启动时设置日志级别为DEBUG。这样能捕获到原生层抛出的具体错误信息，而不只是一个笼统的PERSISTENT_STORE_FAILURE代码。

• 检查应用的文件系统权限：
  如果你的应用部署在Windows的受保护目录（比如C:\Program Files），可能没有读写数据库文件的权限，导致创建或打开存储失败。可以把应用临时部署到用户目录（比如C:\Users\[你的用户名]\Desktop）测试，或者给应用所在目录添加当前用户的读写权限。

• 测试干净的项目环境：
  有时候项目的缓存或旧配置会干扰，试试新建一个极简的Worklight混合应用，只添加JSONStore初始化逻辑，替换同样的sqlite3.dll并设置密码，看是否能正常运行。如果新项目没问题，那大概率是原项目的配置或缓存问题，比如旧的依赖文件残留。

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