EC2上传文件到SFTP报错failed to send packet header: EOF如何排查？

• 网络层面问题：EC2与SFTP服务器之间的中间网络设备（安全组、NACL、NAT网关、防火墙）存在端口限制、连接超时规则。AWS NAT网关默认空闲连接超时为300秒，闲置的SFTP长连接会被主动切断，复用已断开的连接就会触发EOF报错。
• 服务端配置限制：SFTP服务端配置了IP白名单未加入EC2公网IP，或者对EC2 IP的连接数、单连接生命周期做了限制，主动断开了来自EC2的连接。
• 代码逻辑缺陷：当前代码复用全局单例的SFTP客户端，无连接保活、存活检测与自动重连机制；如果存在多goroutine并发使用同一个SFTP客户端的场景，github.com/pkg/sftp的写操作非并发安全，并发调用会破坏数据包结构触发报错。

• 先在EC2实例上直接使用系统自带的sftp命令行工具连接目标服务器，执行上传、闲置10分钟后再上传的测试，如果命令行也出现相同报错，可确定为网络或服务端问题，排除代码因素。
• 如果命令行测试正常，复现代码报错场景：初始化SFTP客户端后等待5分钟以上再执行上传操作，若必现报错则可确定为空闲连接被切断导致。
• 检查代码中SFTP客户端的使用逻辑，确认是否存在多goroutine同时调用同一个sc实例的情况。

网络/服务端侧调整 #

• 确认EC2安全组出站规则开放目标SFTP服务器的22端口权限，NACL配置允许22端口出站及临时端口入站的流量规则。
• 联系SFTP服务端运维确认EC2公网IP已加入白名单，无连接数、连接时长限制。
• 若使用AWS NAT网关，可根据业务需求调整NAT网关的空闲连接超时时间。

代码侧调整 #

• 给SSH客户端配置添加连接超时与保活参数，避免空闲连接被中间设备切断：

config := ssh.ClientConfig{
    User:            user,
    Auth:            authMethods,
    HostKeyCallback: ssh.InsecureIgnoreHostKey(),
    Timeout:         30 * time.Second, // 连接建立超时时间
    ServerAliveInterval: 60 * time.Second, // 每60秒发送一次保活探测
    ServerAliveCountMax: 3, // 连续3次探测无响应则标记连接失效
}

• 优化SFTP客户端复用逻辑：若上传频率较低，可每次上传前新建SFTP客户端、用完即关闭；若上传频率高，可实现SFTP连接池，每次从池内获取可用连接，避免单例连接断开后全量业务报错。
• 增加连接存活检测与重试逻辑：每次执行上传操作前先调用轻量接口（如sc.Getwd()）检测连接有效性，若检测到连接失效则自动重建；上传触发EOF报错时增加最多3次的重试机制。
• 若必须复用单例SFTP客户端，在所有操作sc的位置加互斥锁，避免多goroutine并发操作导致数据包异常。

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