$artifact * @param list> $candidates Replica fields plus a * nested `backend` array. * @return array */ public static function select(array $artifact, array $candidates): array { $size = $artifact['size_bytes'] ?? null; $sha256 = $artifact['sha256'] ?? null; if (!is_int($size) || $size < 1 || !is_string($sha256) || preg_match('/^[a-f0-9]{64}$/D', $sha256) !== 1) { throw new \InvalidArgumentException( 'Storage artifact identity is invalid' ); } $eligible = []; foreach ($candidates as $candidate) { $backend = $candidate['backend'] ?? null; if (!is_array($backend) || ($candidate['state'] ?? null) !== 'ready' || ($candidate['size_bytes'] ?? null) !== $size || !is_string($candidate['sha256'] ?? null) || !hash_equals($sha256, $candidate['sha256']) || !is_int($candidate['verified_at'] ?? null) || $candidate['verified_at'] < 1) { continue; } $admin = $backend['admin_state'] ?? null; $health = $backend['health_state'] ?? null; if (!in_array($admin, ['active', 'read_only', 'draining', 'disabled'], true) || !in_array($health, ['healthy', 'degraded', 'unknown'], true)) { continue; } $id = $candidate['id'] ?? null; $backendId = $candidate['backend_id'] ?? null; $priority = $backend['write_priority'] ?? null; if (!is_int($id) || $id < 1 || !is_int($backendId) || $backendId < 1 || !is_int($priority) || $priority < 0) { continue; } $candidate['_route_rank'] = [ self::healthRank($health), self::adminRank($admin), ($candidate['role'] ?? '') === 'primary' ? 0 : 1, $priority, $backendId, $id, ]; $eligible[] = $candidate; } if ($eligible === []) { throw new CloudError('对象存储副本当前不可读取', 503); } usort($eligible, static fn (array $left, array $right): int => $left['_route_rank'] <=> $right['_route_rank']); unset($eligible[0]['_route_rank']); return $eligible[0]; } private static function healthRank(string $health): int { return match ($health) { 'healthy' => 0, 'degraded' => 1, default => 2, }; } private static function adminRank(string $state): int { return match ($state) { 'active' => 0, 'read_only', 'draining' => 1, default => 2, }; } }