Flutter开发如何向KeyStore/KeyChain手动添加密钥？

数据老陈

2026-9-30

Flutter OAuth1 密钥非硬编码配置方案

方案1：编译时通过环境变量注入
编译执行Flutter命令时通过--dart-define参数传入密钥，不会在源码中留存明文：
编译示例命令：
```
flutter build apk --dart-define=OAUTH_CONSUMER_KEY=实际密钥值 --dart-define=OAUTH_CONSUMER_SECRET=实际私钥值
```
代码中读取方式：
```
const consumerKey = String.fromEnvironment('OAUTH_CONSUMER_KEY');
const consumerSecret = String.fromEnvironment('OAUTH_CONSUMER_SECRET');
```
读取到值后调用flutter_secure_storage的写入接口存入即可，密钥仅存在于本地开发环境或CI/CD的环境变量配置中，不会进入代码仓库。
方案2：本地私有配置文件加载
在项目根目录创建存储密钥的私有配置文件（如.env），将该文件路径加入.gitignore，永远不提交到代码仓库，配置文件格式示例：
```
OAUTH_CONSUMER_KEY=实际密钥值
OAUTH_CONSUMER_SECRET=实际私钥值
```
代码侧使用dotenv相关工具读取配置文件中的值，再写入flutter_secure_storage即可。团队协作者可单独同步该私有配置文件，不会出现密钥硬编码到公开源码的问题。
方案3：首次启动手动录入
如果不需要在编译阶段预置密钥，可在应用首次启动时新增开发者/管理员录入入口，手动输入consumer key和consumer secret后直接存入flutter_secure_storage，后续启动直接读取存储的值即可，该场景下源码完全不会涉及任何密钥相关的明文。