切换AsyncStorage为Expo SecureStore时出现Key无效错误如何解决

首先明确报错的核心校验规则：

Invalid key provided to SecureStore. Keys must not be empty and contain only alphanumeric characters, ".", "-", and "_"
该规则要求SecureStore的key必须同时满足两个条件：

1. 不能为空、不能是undefined、null等非有效值
2. 只能包含大小写字母、数字，以及.、-、_三种特殊符号，不允许空格、斜杠、中文、@、冒号等其他字符

第一段缓存工具代码排查 #

你怀疑的+号拼接本身不会导致报错，问题出在调用store、get方法时传入的key参数不符合校验规则：

• 检查传入的key是否为空：如果传了空字符串、undefined、null，拼接后会得到cacheundefined、cachenull甚至空值，直接触发报错
• 检查传入的key是否包含非法字符：比如之前适配AsyncStorage时用的key带了/、空格、中文等字符，AsyncStorage没有强校验所以不会报错，切换到SecureStore后就会触发规则
• 快速调试方案：在拼接prefixkey后增加打印逻辑，触发报错时直接查看最终key的内容：

const prefixkey = prefix + key;
console.log('SecureStore 实际使用key：', prefixkey);

• 修复方案：增加key合法性校验和转换逻辑，从根源避免非法key：

async function store(key, value) {
  try {
    // 新增非空校验
    if (!key || typeof key !== 'string') {
      throw new Error('缓存key必须为非空字符串');
    }
    const item = {
      value,
      timestamp: Date.now(),
    };
    // 把非法字符自动替换为下划线，适配规则
    const safeKey = key.replace(/[^a-zA-Z0-9._-]/g, '_');
    const prefixkey = prefix + safeKey;
    await SecureStore.setItemAsync(prefixkey, JSON.stringify(item));
  } 
  // 原有异常处理逻辑
  ...
}
// get方法也同步增加相同的校验和转换逻辑即可

第二段Token存储工具代码排查 #

这段代码中固定使用的key是authToken，本身完全符合SecureStore的规则，只有一种可能触发报错：其他业务代码意外修改了这个key变量的值，只要确认key变量没有被外部篡改，这段代码不会触发该报错。

通用验证方法 #

你可以在所有调用SecureStore方法的位置新增key打印，触发报错时直接匹配对应的非法key，就能快速定位到具体是哪次调用、传了什么不符合规则的key。

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