缓存键为空源于业务代码中变量未定义或未赋值，而非redis返回空值；需检查键构造逻辑、添加调试日志、校验键合法性、统一封装键生成方法，并结合redis命令反向验证。
缓存键变量显示为空，通常不是 Redis 返回了空值，而是生成键的代码里变量本身未定义、未赋值或作用域错误，导致拼出来的 key 字符串成了 ":123"、"user:" 或直接是空字符串。排查重点不在 Redis 侧，而在业务代码中键的构造逻辑。
检查键生成前的变量是否真实可用
缓存键常由前缀 + ID 拼接而成（如 "user:" . $userId）。如果 $userId 是 null、空字符串、未声明或作用域外变量，拼接结果必然异常。
- 在拼接 key 的位置前后加日志或调试输出：
var_dump($userId); echo "key: user:$userId"; - 确认该变量是否来自函数参数、数据库查询结果、API 响应等——这些来源都可能返回 null 或空，不能默认“一定有值”
- 特别注意 PHP 中
$_GET['id']、$_POST['token']等超全局变量，未传参时直接访问会触发Undefined array key警告，但不会中断执行，变量值为 null，进而污染 key
验证键字符串是否合法且非空
不要假设“拼出来了就一定对”。生成 key 后，立刻做一次基础校验：
- 用
isset($key) && is_string($key) && strlen(trim($key)) > 0判断键是否有效 - 避免使用
empty()，因为它会把"0"、"false"等合法字符串也判为“空” - 若校验失败，直接抛出异常或记录 warn 日志，而不是继续调用
get($key)—— 否则你在查一个根本不存在的 key，Redis 当然返回 nil
统一管理键生成逻辑，避免散落多处
键拼接逻辑写在多个地方（比如控制器、服务类、DAO 层各写一遍），极易出现不一致：一处忘了判空，一处前缀写错，一处 ID 类型没转字符串……
- 封装一个专用方法，例如
CacheKey::user(int $id): string，内部强制校验$id并格式化 - 所有缓存读写必须通过该方法获取 key，禁止手写
"user:".$id - 配合 IDE 类型提示和静态分析（如 PHPStan），让未定义变量在编码阶段就被捕获
结合 Redis 实际响应反向验证
即使 key 变量未定义，Redis 也可能“安静地”返回空响应，掩盖问题。需主动确认行为：
- 用
redis-cli手动执行exists "user:"或exists ""—— 如果这类非法 key 真的存在，说明上游确实传入了空值并被缓存了 - 查
info stats中的keyspace_hits/keyspace_misses，若 miss 极高但业务日志显示“查了缓存”，大概率是 key 拼错了 - 开启 Redis 的
slowlog或用monitor抓取真实发出的 key，和代码中预期的 key 逐字比对
