字典数组非持久化检查异常：重复添加区域问题排查求助

看起来你遇到了一个挺棘手的偶发问题——明明只有parse_r()这一个入口添加新区域，却偶尔会出现重复添加的情况，结合你给出的信息，我来帮你梳理下可能的成因和对应的操作疏漏：

可能的核心成因 #

1. 并发场景下的竞态条件（最可能的原因） #

如果你的代码运行在多进程/多请求环境（比如PHP-FPM、多线程服务），全局变量$regions是进程隔离的——每个请求都会独立初始化一份$regions数组。举个例子：

• 请求A处理某个regionCode，检查自己进程内的$regions发现不存在，准备向数据库插入新区域
• 同时请求B也处理同一个regionCode，同样在自己的进程内检查到不存在，也执行插入操作
• 最终两个请求都完成插入，导致数据库出现重复的区域记录

这种情况刚好符合你“50次中有1次”的偶发现象——只有当两个请求在极短时间内同时处理同一个未缓存的regionCode时才会触发。

2. 检查与插入操作的原子性缺失 #

假设parse_r()内的逻辑是先检查$regions、再查数据库、最后插入，那“检查数据库”和“插入数据”是两个独立的操作，中间存在时间窗口。如果在这个窗口内有其他请求完成了插入，当前请求就会因为没检测到新插入的记录，重复执行添加动作。

3. regionCode的字符串一致性问题 #

你提到regionCode是非唯一文本字段，但可能存在肉眼不可见的格式差异：

• 大小写差异：比如"Beijing"和"beijing"
• 首尾空格：比如"Shanghai "和"Shanghai"
• 编码差异：比如全角/半角字符、不同UTF-8变体

这些差异会让$regions数组认为是新的regionCode，从而执行添加操作，但最终插入的区域名称是相同的，看起来就像是重复添加。

4. 全局变量$regions的生命周期局限 #

在PHP中，全局变量的生命周期仅限于当前请求。如果get_...函数是从数据库加载$regions，那么每个请求都会重新加载一份旧数据——也就是说，请求A添加的新regionCode，请求B的$regions里是看不到的，直到请求B重新从数据库加载，这也会导致后续请求可能重复插入。

对应的修复建议 #

• 解决竞态与原子性问题：改用数据库层面的原子操作，比如使用INSERT ... ON DUPLICATE KEY UPDATE（如果区域名称需要唯一，先给name字段加唯一约束），或者用事务+排他锁确保操作原子性：

  $mysqli->begin_transaction();
  // 先加排他锁查询，防止其他请求同时插入
  $result = $mysqli->query("SELECT id FROM regions WHERE name = '$name' FOR UPDATE");
  if (!$result->num_rows) {
      $mysqli->query("INSERT INTO regions (code, name) VALUES ('$newRegionCode', '$name')");
      $regions[$newRegionCode] = $mysqli->insert_id;
  }
  $mysqli->commit();
  

• 标准化regionCode格式：在检查前对regionCode做统一处理，消除格式差异：

  $normalizedCode = trim(strtolower($newRegionCode));
  if (!isset($regions[$normalizedCode])) {
      // 后续逻辑使用标准化后的code
  }
  

• 替换进程内缓存为分布式缓存：如果是多进程环境，不要依赖全局变量做缓存，改用Redis、Memcached等分布式缓存来存储$regions的映射关系，确保所有进程共享同一套缓存数据。

内容的提问来源于stack exchange，提问作者IT-O