PHP实现导入场景下编号已存在时连续递增至未占用值的方法

原有代码的核心问题 #

• 循环判断逻辑完全颠倒：checkIfNumberExists 方法的返回值是数据库匹配的记录计数，即编号存在时返回值大于0，不存在时返回值小于等于0。原有代码把“编号不存在”作为循环触发条件，会导致编号持续自增形成死循环，完全违背“找到未占用编号即停止”的设计目标。
• 校验范围存在缺口：仅校验数据库中的存量记录，没有把本次导入批次内待写入的编号纳入占用校验池，新生成的编号很容易和导入文件自带的编号冲突。
• 无批次内的重复防护：没有对导入文件内的重复编号做预处理，同批次导入的记录很容易拿到相同的编号。

落地实现步骤 #

• 提前构建全量占用编号池
  • 查询指定所属公司、指定标签维度下，数据库现有记录的最大编号值作为计算基准
  • 遍历本次导入文件的编号列，收集所有非空的编号值，先对文件内的重复值做去重处理
  • 合并数据库存量编号、导入文件待写入编号为统一的占用集合，取集合内的最大值作为编号自增的初始起点
• 修正循环校验逻辑
  • 循环触发条件改为当前编号已被占用时（即checkIfNumberExists返回值大于0），才执行编号自增操作
  • 每次自增后重新校验，直到校验结果为不存在时停止循环，此时得到的编号就是可用的不重复编号
• 导入写入阶段的兜底防护
  • 写入导入记录时，每写入一条就把对应编号加入内存占用池，避免同批次后续记录生成重复编号
  • 数据库层面给“所属公司字段+标签列+编号列”建立联合唯一索引，从底层杜绝并发场景下的编号重复问题

修正后的代码参考 #

// 1. 构建全量占用集合
$existingMaxNumber = GlobalModel::getMaxNumberByScope($data['table'], $data['tag_column'], $data['tag_value']);
$importNumberPool = array_unique(array_filter($importFileNumberList)); // 导入文件编号去重
$allOccupied = array_merge([$existingMaxNumber], $importNumberPool);
$candidateNumber = max($allOccupied); // 取全集合最大值作为初始候选值

// 2. 修正循环逻辑：仅当编号被占用时才自增
while(GlobalModel::checkIfNumberExists($data['table'], $candidateNumber, $data['tag_column'], $data['tag_value']) > 0) {
    $candidateNumber++;
}

// 3. 写入正式记录
$data['number'] = $candidateNumber;
// 后续业务逻辑...

对应你举的场景：存量最大编号为1，导入文件待写入编号为2、3、4，合并后的占用集合最大值为4，初始候选值为4。因为导入的待写入值还未真正落库，只要把这些待写入值纳入内存校验范围，就能正确生成不冲突的编号，不会再出现只生成编号2的问题。

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