PHP连接AWS Redis可读写但Keys/Scan无法查找键的问题

1. 检查缓存键生成的上下文变量一致性 #

这是最可能的核心原因：生成缓存键和执行缓存失效时，self::$useAppDB等全局状态变量的取值不一致。

• 在select方法生成缓存键时，$appDbName由self::$useAppDB决定；但执行插入/更新/删除操作触发invalidateCache时，如果self::$useAppDB的取值发生了变化（比如切换了数据库上下文），会导致生成的pattern中的appDbName和实际缓存键中的值不匹配，自然无法找到目标键。
• 验证方式：在select方法里添加日志，输出实际生成的cacheKey，和invalidateCache里的pattern做对比，看是否存在差异。
• 解决方法：确保invalidateCache使用和select完全一致的上下文生成pattern，比如将$appDbName作为参数传入invalidateCache，避免依赖可能变化的全局状态。

2. 适配AWS Redis无服务器的分片架构限制 #

AWS ElastiCache Redis无服务器采用集群分片架构，KEYS命令仅能返回当前连接所在分片的键，如果缓存键分布在其他分片，就会出现redis-cli能查到（cli可能自动路由到对应分片）但PHP应用调用KEYS找不到的情况。

• 替代方案：改用SCAN命令遍历所有匹配键，PHP Redis扩展的scan方法支持迭代获取全部分片的键：

  private static function invalidateCache($table) {
      if (self::$redis) {
          try {
              $pattern = self::generateCacheKey("select:$table", "*");
              error_log("Generated pattern: $pattern");
              
              $iterator = null;
              $keys = [];
              // 用SCAN迭代获取所有匹配键
              while ($result = self::$redis->scan($iterator, $pattern)) {
                  $keys = array_merge($keys, $result);
              }
              
              if (!empty($keys)) {
                  error_log("Keys found for pattern {$pattern}: " . print_r($keys, true));
                  self::$redis->del($keys); // 批量删除更高效
              } else {
                  error_log("No keys matched the pattern {$pattern}");
              }
          } catch (\Exception $e) {
              error_log("Redis error while invalidating cache for table $table: " . $e->getMessage());
          }
      } else {
          error_log("Redis is not initialized.");
      }       
  }
  

• 优化建议：使用**哈希标签（Hash Tags）**让同一表的缓存键落在同一个分片，修改generateCacheKey方法：

  $key = "{$deploymentSalt}:{$dbName}:{$appDbName}:{select:$table}";
  if ($identifier) {
      $key .= ":{$identifier}";
  }
  

  Redis会根据{}内的内容计算哈希值，确保同一表的所有缓存键都分配到同一个分片，后续KEYS或SCAN就能找到所有匹配键。

3. 确认Redis数据库编号一致 #

检查PHP应用连接Redis时使用的数据库编号，和你用redis-cli连接时的编号是否一致：

• 如果PHP代码里调用了$redis->select($dbNum)切换了数据库，而redis-cli默认使用db0，就会导致两边看到的键不在同一个库。
• 验证方式：在select和invalidateCache方法中打印当前数据库编号：echo self::$redis->getDbNum();，和redis-cli里的SELECT命令对比。

4. 验证通配符匹配逻辑 #

直接在PHP中测试pattern是否匹配实际存在的缓存键：

• 取出一个已知存在的缓存键，用fnmatch($pattern, $actualKey)测试是否匹配，确认pattern的生成逻辑没有问题。

内容的提问来源于stack exchange，提问作者Kenneth P. Hough