Flutter Go中的本地数据库加密：保护敏感数据

【免费下载链接】flutter-go flutter 开发者帮助 APP，包含 flutter 常用 140+ 组件的demo 演示与中文文档 项目地址: https://gitcode.com/gh_mirrors/fl/flutter-go

在移动应用开发中，本地数据库（Local Database）是存储用户数据的重要方式，但默认情况下数据以明文形式存储，存在安全风险。本文将介绍如何在Flutter Go项目中实现本地数据库加密，保护用户收藏记录、浏览历史等敏感数据。

项目数据库现状分析

Flutter Go使用SQLite作为本地数据库，主要存储三类核心数据：

• 组件分类数据（lib/model/cat.dart）
• 用户收藏记录（lib/model/collection.dart）
• 组件文档数据（lib/model/widget.dart）

数据库初始化代码位于lib/utils/provider.dart，当前实现直接使用明文数据库：

String databasesPath = await getDatabasesPath();
String path = join(databasesPath, 'flutter.db');
db = await openDatabase(path); // 无加密参数

敏感数据保护的必要性

未加密的SQLite数据库存在两大安全隐患：

1. 设备root后可直接读取数据库文件
2. 应用备份数据中可能包含敏感信息

在Flutter Go中，用户收藏记录（lib/model/collection.dart）包含用户偏好设置，属于需要保护的敏感数据。项目资源中已包含加密相关图标：

• 加密状态图标：
• 无加密图标：

集成SQLCipher实现加密

添加依赖

修改pubspec.yaml，添加SQLCipher兼容的数据库依赖：

dependencies:
  sqflite_sqlcipher: ^2.2.0  # 替换原sqflite依赖

修改数据库初始化代码

更新lib/utils/provider.dart中的数据库打开方式，添加加密密钥：

// 原代码
db = await openDatabase(path);

// 修改为加密版本
db = await openDatabase(
  path,
  password: 'your-encryption-key',  // 建议从安全存储获取密钥
  version: 1
);

数据迁移策略

对于已存在的明文数据库，需要执行加密迁移：

// 加密现有数据库的示例代码
Future encryptExistingDatabase(String path, String password) async {
  // 1. 打开明文数据库
  final db = await openDatabase(path);
  
  // 2. 导出数据
  final data = await db.rawQuery('SELECT * FROM collection');
  
  // 3. 关闭并删除原数据库
  await db.close();
  await deleteDatabase(path);
  
  // 4. 创建加密数据库并导入数据
  final encryptedDb = await openDatabase(path, password: password);
  for (var row in data) {
    await encryptedDb.insert('collection', row);
  }
}

密钥管理最佳实践

安全存储密钥

推荐使用flutter_secure_storage存储加密密钥：

dependencies:
  flutter_secure_storage: ^8.0.0

实现代码示例：

import 'package:flutter_secure_storage/flutter_secure_storage.dart';

final storage = FlutterSecureStorage();
// 存储密钥
await storage.write(key: 'db_key', value: 'your-encryption-key');
// 获取密钥
String? key = await storage.read(key: 'db_key');

密钥生成策略

建议采用以下密钥生成方式：

1. 首次启动时生成随机密钥
2. 使用设备唯一标识+应用签名作为密钥种子
3. 定期密钥轮换机制

完整实现代码

加密数据库工具类

创建lib/utils/encrypted_db.dart：

import 'package:sqflite_sqlcipher/sqflite.dart';
import 'package:flutter_secure_storage/flutter_secure_storage.dart';

class EncryptedDatabase {
  static final FlutterSecureStorage _storage = FlutterSecureStorage();
  static Database? _db;

  static Future<Database> getInstance() async {
    if (_db != null) return _db!;
    
    final path = join(await getDatabasesPath(), 'flutter_go_encrypted.db');
    final key = await _getEncryptionKey();
    
    _db = await openDatabase(
      path,
      password: key,
      version: 2,
      onCreate: (db, version) async {
        // 创建表结构
        await db.execute('''
          CREATE TABLE collection (
            id INTEGER PRIMARY KEY,
            name TEXT,
            router TEXT
          )
        ''');
      }
    );
    return _db!;
  }
  
  static Future<String> _getEncryptionKey() async {
    String? key = await _storage.read(key: 'db_encryption_key');
    if (key == null) {
      key = _generateRandomKey();
      await _storage.write(key: 'db_encryption_key', value: key);
    }
    return key;
  }
  
  static String _generateRandomKey() {
    // 生成16字节随机密钥
    final random = Random.secure();
    final values = List<int>.generate(16, (i) => random.nextInt(256));
    return base64.encode(values);
  }
}

修改数据模型使用加密数据库

以lib/model/collection.dart为例：

// 修改前
sql = Sql.setTable(table);

// 修改后
db = await EncryptedDatabase.getInstance();

验证加密效果

加密状态检查

添加加密状态检查工具函数：

Future<bool> isDatabaseEncrypted(String path) async {
  final file = File(path);
  final bytes = await file.readAsBytes();
  
  // SQLCipher加密文件以0x43544543开头
  return bytes.length >= 4 && 
         bytes[0] == 0x43 && 
         bytes[1] == 0x54 && 
         bytes[2] == 0x45 && 
         bytes[3] == 0x43;
}

集成到应用设置界面

在用户设置页面添加加密状态指示器：

Widget buildEncryptionStatus() {
  return FutureBuilder<bool>(
    future: isDatabaseEncrypted(databasePath),
    builder: (context, snapshot) {
      if (snapshot.data == true) {
        return Row(
          children: [
            Icon(Icons.enhanced_encryption, color: Colors.green),
            Text('数据库已加密')
          ],
        );
      } else {
        return Row(
          children: [
            Icon(Icons.no_encryption, color: Colors.red),
            Text('数据库未加密')
          ],
        );
      }
    },
  );
}

总结与注意事项

1. 性能影响：加密会带来约5-10%的性能损耗，建议只对敏感表启用加密
2. 密钥备份：确保密钥安全存储，丢失密钥将导致数据无法恢复
3. 版本兼容性：SQLCipher版本需与Flutter SDK匹配

通过以上步骤，Flutter Go项目可以实现本地数据库加密，有效保护用户敏感数据。完整实现可参考项目文档docs/api.md中的"数据安全"章节。

提示：生产环境中应使用更复杂的密钥管理方案，如结合生物识别或服务器密钥分发

【免费下载链接】flutter-go flutter 开发者帮助 APP，包含 flutter 常用 140+ 组件的demo 演示与中文文档 项目地址: https://gitcode.com/gh_mirrors/fl/flutter-go