uni-app本地存储数据如何加密？

Question

在使用uni-app进行跨平台开发时，本地存储敏感数据（如用户信息、令牌等）的安全性至关重要。由于uni-app默认使用的是明文存储方式（如uni.setStorageSync），一旦设备被越狱或root，数据极易被读取，存在较大安全隐患。因此，开发者常面临如何对本地存储数据进行加密的问题。常见的解决方案包括：使用对称加密算法（如AES）对数据加密后再存储、结合平台特性调用原生加密模块、或引入第三方安全库提升防护能力。本文将探讨这些加密策略的具体实现与适用场景。

Answer 1

一、本地存储敏感数据的安全隐患

在uni-app开发中，开发者通常使用uni.setStorageSync进行本地持久化存储。然而，这种默认的明文存储方式存在明显的安全风险。

• 设备一旦被越狱或root，攻击者可直接访问应用沙盒文件系统，读取敏感信息。
• 用户凭证、token等关键数据若未加密，将面临泄露和篡改的风险。
• 部分安卓设备允许通过adb调试工具访问内部存储，进一步放大了安全隐患。

因此，在涉及金融、社交、企业级应用等场景下，必须对本地存储的数据进行加密处理。

二、常见的加密策略与实现方式

目前主流的解决方案包括：

1. 使用对称加密算法（如AES）对数据加密后再存储。
2. 结合平台特性调用原生加密模块（如iOS的Keychain、Android的Keystore）。
3. 引入第三方安全库（如crypto-js、forge、uni-secure-storage等）提升防护能力。

方案类型	优点	缺点	适用场景
AES加密	跨平台兼容性好，易于实现	密钥管理困难，易被逆向破解	通用型数据加密
原生加密模块	安全性高，依赖系统机制	开发成本高，需编写原生代码	对安全要求极高的应用
第三方安全库	集成方便，功能丰富	可能存在漏洞，依赖维护	快速实现加密需求

三、对称加密的实现示例（AES）

以下是一个使用CryptoJS库进行AES加密的uni-app示例代码：

import CryptoJS from 'crypto-js';

const KEY = CryptoJS.enc.Utf8.parse('1234567890123456'); // 16字节
const IV = CryptoJS.enc.Utf8.parse('1234567890123456');

function encrypt(data) {
    let encrypted = CryptoJS.AES.encrypt(
        data,
        KEY, 
        { iv: IV, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 }
    );
    return encrypted.toString();
}

function decrypt(cipherText) {
    let decrypted = CryptoJS.AES.decrypt(
        cipherText, 
        KEY, 
        { iv: IV, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 }
    );
    return decrypted.toString(CryptoJS.enc.Utf8);
}

// 存储加密数据
uni.setStorageSync('token', encrypt('my-secret-token'));

// 读取解密数据
let token = decrypt(uni.getStorageSync('token'));
console.log(token); // 输出：my-secret-token

虽然该方法能有效防止明文泄露，但密钥硬编码在JS中仍存在被反编译获取的风险。

四、调用原生加密模块的实践路径

为了提升安全性，建议在uni-app中通过条件编译调用各平台的原生加密机制：

graph TD A[uni-app应用] --> B{判断平台} B -->|H5| C[Web Crypto API] B -->|App-iOS| D[iOS Keychain] B -->|App-Android| E[Android Keystore] B -->|小程序| F[自定义加密逻辑] C --> G[前端加密存储] D --> H[系统级加密存储] E --> I[系统级加密存储] F --> J[小程序安全存储插件]

• iOS可通过OC代码封装Keychain操作，保存敏感数据。
• Android可通过Java/Kotlin使用Keystore系统生成密钥并加密数据。
• H5端可以借助浏览器的Web Crypto API进行安全加密。

这种方式虽然增加了开发复杂度，但显著提升了数据存储的安全等级。

五、引入第三方安全库的折中方案

对于希望兼顾开发效率与安全性的项目，可以考虑使用uni-app生态中已有的安全库，例如：

• uni-secure-storage：基于原生实现的加密存储插件。
• Forge：纯JavaScript实现的加密库，支持多种算法。
• CryptoJS：广泛使用的加密库，适合基础加密需求。

以uni-secure-storage为例，其使用方式如下：

// 安装插件后
const secureStorage = require('uni-secure-storage');

// 设置加密数据
await secureStorage.setItem('user_token', 'my-secret-token');

// 获取解密数据
let token = await secureStorage.getItem('user_token');
console.log(token); // 输出：my-secret-token

此类插件通常会结合平台特性自动选择最优的加密方式，是平衡安全与开发效率的良好选择。