Laravel 8 Flysystem SFTP如何检测连接成功 失败时跳过执行

你当前的代码无法捕获连接异常、导致任务中断的核心原因有两个：

• Flysystem SFTP驱动默认采用懒连接机制：调用createSFtpDriver()时不会实际发起SSH/SFTP连接，只有执行exists()、files()这类文件操作时才会触发真实连接，而连接失败抛出的异常未被你的catch块正确捕获。
• 异常捕获范围不全：SFTP连接、认证阶段抛出的异常来自Flysystem、底层SSH依赖库phpseclib，包含Exception子类和Error类异常；如果你的控制台命令在自定义命名空间下，未引入全局Exception类时，写catch (Exception $e)实际只会匹配当前命名空间下的Exception类，既无法匹配跨命名空间的第三方扩展异常，也没有覆盖Error级别的异常，会导致异常直接逃逸、中断整个循环流程。

核心调整点 #

• 捕获全局命名空间下的\Throwable，覆盖所有可能的异常和错误，保证单组账号出错不会终止整个循环
• 主动触发适配器连接，在业务逻辑执行前提前完成连接校验，避免连接逻辑散落在业务代码中
• 增加错误日志记录，方便后续排查对应账号的连接失败原因，注意不要在日志中输出密码等敏感信息
• 建议给SFTP配置增加超时参数，避免单台服务器网络不通时长时间阻塞整个任务

修正后的代码 #

foreach ($credentials as $cred) {
    try {
        $driver = Storage::createSFtpDriver($cred);
        // 主动获取适配器实例并发起连接，提前捕获连接、认证类异常
        $adapter = $driver->getAdapter();
        if (method_exists($adapter, 'connect')) {
            $adapter->connect();
        }

        if (!$driver->exists('/reports/')) {
            continue;
        }

        // 此处编写对应SFTP账号的文件读取业务逻辑
        // 例：$reportFiles = $driver->allFiles('/reports/');

    } catch (\Throwable $e) {
        // 记录失败日志，仅记录非敏感的账号标识和错误信息
        \Log::warning('单组SFTP账号处理跳过', [
            'host' => $cred['host'] ?? 'unknown',
            'username' => $cred['username'] ?? 'unknown',
            'error' => $e->getMessage()
        ]);
        continue;
    }
}

可选优化 #

你可以在每组SFTP的配置参数中增加'timeout' => 10配置，设置10秒连接超时，避免网络异常时任务长时间挂起。

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