Docker容器中.NET 6 FTP上传代码行为异常排查求助

1. 给FluentFTP添加调试日志 #

FluentFTP内置日志系统，能输出FTP连接、传输、断开的全流程交互细节，是排查环境差异的核心手段。在程序初始化阶段添加日志监听即可：

// 输出到控制台，容器内可通过docker logs查看
FtpTrace.AddListener(new ConsoleTraceListener());
// 开启详细日志级别，包含所有命令、响应及状态变化
FtpTrace.LogLevel = FtpTraceLevel.Verbose;

如果需要持久化日志，可添加文件监听（容器内建议挂载宿主机目录映射日志文件路径）：

FtpTrace.AddListener(new TextWriterTraceListener("/app/ftp-debug.log"));

2. 容器内无异常的可能原因及排查 #

网络栈差异 #

Windows与Docker容器的TCP/IP栈实现逻辑不同：

• Windows系统会快速响应TCP断连（如RST包），直接触发Socket异常；
• 容器内的Linux网络栈默认TCP keepalive参数（如tcp_keepalive_time）偏长，导致FluentFTP无法及时感知连接断开，会继续执行后续操作直到超时，而非立刻抛出异常。

修复方案：手动配置FluentFTP的Socket keepalive参数，强制快速检测断连：

var client = new FtpClient("ftp-server-address", "username", "password");
// 开启Socket keepalive机制
client.SocketKeepAlive = true;
// 连接闲置10秒后开始发送探测包
client.SocketKeepAliveTime = 10000;
// 每3秒发送一次探测包
client.SocketKeepAliveInterval = 3000;

版本或配置不一致 #

• 检查Windows与容器内的FluentFTP版本是否一致，执行dotnet list package FluentFTP确认版本号；
• 排查代码中是否存在环境分支逻辑，比如容器内修改了Timeout、ReadTimeout等参数，导致断连后未触发异常。

异常捕获与日志输出问题 #

可能容器内的异常被捕获但未输出：

• 检查代码中的try-catch块，确认是否存在捕获异常后未记录日志的情况；
• 验证容器日志输出是否正常，通过docker logs <容器ID>查看控制台输出。

3. 额外排查动作 #

• 在上传每个文件前，主动检测连接状态：

if (!client.IsConnected) {
    throw new InvalidOperationException("FTP连接已断开，终止当前上传任务");
}
// 或发送NOOP命令触发连接有效性检测
client.Noop();

• 对比Windows与容器内的FTP调试日志，重点关注断连时的TCP交互、FluentFTP的状态变化，定位行为差异的具体节点。

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