WPF框架下FTP客户端开发与优化实践

1. WPF框架下的FTP客户端开发概述

在工业自动化、医疗影像传输等需要高频文件交互的领域，FTP客户端工具一直是刚需。传统方案如FileZilla虽然功能完善，但无法与企业内部系统深度集成。基于C#.NET的WPF框架开发定制化FTP客户端，既能满足目录遍历、文件传输等核心功能，又能实现与企业认证系统、工作流引擎的无缝对接。

我去年为某医疗器械厂商开发的DICOM影像传输系统就采用了这种方案。相比WinForm，WPF的数据绑定和矢量渲染特性让复杂传输状态的UI呈现更加流畅。MVVM模式则让后台传输逻辑与前端展示完全解耦——当需要从FTP协议切换到SFTP时，仅需重写Model层，View层几乎零改动。

2. 核心功能模块实现

2.1 连接管理与目录遍历

使用.NET内置的FtpWebRequest类实现基础连接时，需要注意一个关键细节：默认的KeepAlive属性在长时间空闲连接时会失效。解决方案是继承FtpWebRequest实现自定义连接池：

csharp复制public class FtpClient : IDisposable
{
    private FtpWebRequest _request;
    private NetworkCredential _credential;
    
    public void Connect(string host, int port, string user, string password)
    {
        _credential = new NetworkCredential(user, password);
        var uri = new Uri($"ftp://{host}:{port}");
        _request = (FtpWebRequest)WebRequest.Create(uri);
        _request.KeepAlive = false; // 禁用默认KeepAlive
        _request.ConnectionGroupName = Guid.NewGuid().ToString(); // 唯一连接组
        _request.Credentials = _credential;
    }
    
    public List<string> ListDirectory(string path)
    {
        _request.Method = WebRequestMethods.Ftp.ListDirectory;
        _request.ConnectionGroupName = Guid.NewGuid().ToString(); // 每次请求新连接
        
        using (var response = (FtpWebResponse)_request.GetResponse())
        using (var stream = response.GetResponseStream())
        using (var reader = new StreamReader(stream))
        {
            return reader.ReadToEnd()
                .Split(new[] { "\r\n" }, StringSplitOptions.RemoveEmptyEntries)
                .ToList();
        }
    }
}

目录列表的缓存策略直接影响用户体验。建议采用LRU缓存算法，对频繁访问的目录（如每日交接的"/inbox"）设置较长的过期时间：

csharp复制private readonly LRUCache<string, List<string>> _dirCache = 
    new LRUCache<string, List<string>>(capacity: 50);

public List<string> GetCachedList(string path)
{
    if (_dirCache.TryGet(path, out var cached))
        return cached;
        
    var freshList = ListDirectory(path);
    _dirCache.Add(path, freshList);
    return freshList;
}

2.2 文件传输的断点续传实现

FTP协议的REST命令支持断点续传，但需要正确处理本地文件状态。以下是关键实现步骤：

1. 上传时先获取远程文件大小：

csharp复制long GetRemoteFileSize(string remotePath)
{
    _request.Method = WebRequestMethods.Ftp.GetFileSize;
    _request.ConnectionGroupName = Guid.NewGuid().ToString();
    
    using (var response = (FtpWebResponse)_request.GetResponse())
    {
        return response.ContentLength;
    }
}

2. 下载时检查本地文件并设置偏移量：

csharp复制public void DownloadFile(string remotePath, string localPath, Action<double> progressCallback)
{
    long existingSize = File.Exists(localPath) ? new FileInfo(localPath).Length : 0;
    long remoteSize = GetRemoteFileSize(remotePath);
    
    if (existingSize > 0 && existingSize < remoteSize)
    {
        // 断点续传模式
        _request.Method = WebRequestMethods.Ftp.DownloadFile;
        _request.ContentOffset = existingSize;
        
        using (var response = (FtpWebResponse)_request.GetResponse())
        using (var remoteStream = response.GetResponseStream())
        using (var localStream = new FileStream(localPath, FileMode.Append))
        {
            CopyStreamWithProgress(remoteStream, localStream, remoteSize - existingSize, progressCallback);
        }
    }
    else
    {
        // 全新下载
        _request.Method = WebRequestMethods.Ftp.DownloadFile;
        _request.ContentOffset = 0;
        
        using (var response = (FtpWebResponse)_request.GetResponse())
        using (var remoteStream = response.GetResponseStream())
        using (var localStream = new FileStream(localPath, FileMode.Create))
        {
            CopyStreamWithProgress(remoteStream, localStream, remoteSize, progressCallback);
        }
    }
}

重要提示：FTP服务器必须支持REST命令（大多数现代服务器都支持），否则ContentOffset设置会抛出协议错误。测试时建议用FileZilla Server搭建本地环境验证。

2.3 基于WPF的传输队列可视化

利用WPF的DataBinding和ObservableCollection实现实时传输列表：

xml复制<!-- XAML部分 -->
<ListView ItemsSource="{Binding TransferQueue}">
    <ListView.View>
        <GridView>
            <GridViewColumn Header="文件名" DisplayMemberBinding="{Binding FileName}"/>
            <GridViewColumn Header="进度">
                <GridViewColumn.CellTemplate>
                    <DataTemplate>
                        <ProgressBar Value="{Binding Progress}" 
                                   Height="20" Width="150"/>
                    </DataTemplate>
                </GridViewColumn.CellTemplate>
            </GridViewColumn>
        </GridView>
    </ListView.View>
</ListView>

后台ViewModel维护传输状态：

csharp复制public class TransferViewModel : INotifyPropertyChanged
{
    public ObservableCollection<TransferItem> TransferQueue { get; } 
        = new ObservableCollection<TransferItem>();
        
    public void EnqueueDownload(string remotePath, string localPath)
    {
        var item = new TransferItem {
            FileName = Path.GetFileName(remotePath),
            Progress = 0
        };
        
        TransferQueue.Add(item);
        
        Task.Run(() => {
            _ftpClient.DownloadFile(remotePath, localPath, progress => {
                Application.Current.Dispatcher.Invoke(() => {
                    item.Progress = progress;
                });
            });
        });
    }
}

3. 性能优化实战技巧

3.1 连接池的精细化控制

通过ServicePointManager优化TCP连接复用：

csharp复制// 应用启动时配置全局连接策略
ServicePointManager.DefaultConnectionLimit = 20; // 默认是2
ServicePointManager.Expect100Continue = false;
ServicePointManager.UseNagleAlgorithm = false;

// 针对特定FTP主机单独配置
var sp = ServicePointManager.FindServicePoint(new Uri("ftp://example.com"));
sp.ConnectionLeaseTimeout = 60 * 1000; // 1分钟后释放连接
sp.MaxIdleTime = 30 * 1000; // 30秒空闲超时

3.2 大文件传输的内存优化

处理GB级文件时，必须避免内存暴涨：

csharp复制void CopyStreamWithProgress(Stream input, Stream output, long totalBytes, Action<double> progress)
{
    byte[] buffer = new byte[32 * 1024]; // 32KB缓冲区
    long totalRead = 0;
    int read;
    
    while ((read = input.Read(buffer, 0, buffer.Length)) > 0)
    {
        output.Write(buffer, 0, read);
        totalRead += read;
        progress?.Invoke((double)totalRead / totalBytes * 100);
    }
}

3.3 异步操作的正确处理模式

避免async/await的常见陷阱：

csharp复制// 错误示例：会导致UI线程阻塞
public void DownloadButton_Click(object sender, EventArgs e)
{
    var task = _ftpClient.DownloadFileAsync(...);
    task.Wait(); // 死锁风险
}

// 正确模式：
public async void DownloadButton_Click(object sender, EventArgs e)
{
    try 
    {
        await _ftpClient.DownloadFileAsync(...);
    }
    catch (WebException ex)
    {
        // 处理FTP 550等错误码
        if (ex.Response is FtpWebResponse response)
        {
            ShowError($"FTP错误 {(int)response.StatusCode}: {response.StatusDescription}");
        }
    }
}

4. 企业级功能扩展

4.1 与Active Directory集成

通过WindowsIdentity实现单点登录：

csharp复制public bool ConnectWithAD(string host)
{
    var windowsIdentity = WindowsIdentity.GetCurrent();
    if (windowsIdentity == null) return false;
    
    var credential = new NetworkCredential(
        windowsIdentity.Name, 
        "", 
        windowsIdentity.Name.Split('\\')[0]);
    
    _request.Credentials = credential;
    _request.EnableSsl = true; // 必须启用SSL
    
    try 
    {
        var response = (FtpWebResponse)_request.GetResponse();
        response.Close();
        return true;
    }
    catch 
    {
        return false;
    }
}

4.2 传输任务持久化

使用SQLite保存传输记录：

csharp复制public class TransferRecorder
{
    private SQLiteConnection _db;
    
    public TransferRecorder()
    {
        _db = new SQLiteConnection("Data Source=transfers.db");
        _db.CreateTable<TransferRecord>();
    }
    
    public void RecordTransfer(string operation, string remotePath, string localPath, bool success)
    {
        _db.Insert(new TransferRecord {
            Timestamp = DateTime.UtcNow,
            Operation = operation,
            RemotePath = remotePath,
            LocalPath = localPath,
            Success = success
        });
    }
    
    public IEnumerable<TransferRecord> GetRecentTransfers(int count)
    {
        return _db.Table<TransferRecord>()
                 .OrderByDescending(r => r.Timestamp)
                 .Take(count);
    }
}

4.3 与OPC Server的联动

通过OPCDAAuto实现生产设备到FTP的自动传输：

csharp复制public class OpcToFtpBridge
{
    private OPCServer _opcServer;
    private FtpClient _ftpClient;
    
    public void StartMonitoring(string opcServerName, string itemId, string ftpPath)
    {
        _opcServer = new OPCServer();
        _opcServer.Connect(opcServerName);
        
        var group = _opcServer.OPCGroups.Add("FTPBridge");
        group.IsActive = true;
        
        var item = group.OPCItems.AddItem(itemId, 0);
        item.DataChange += (cancel, transaction, numItems, clientHandles, itemValues, qualities, timeStamps) => 
        {
            var tempFile = Path.GetTempFileName();
            File.WriteAllBytes(tempFile, (byte[])itemValues[0]);
            
            _ftpClient.UploadFile(tempFile, $"{ftpPath}/{DateTime.Now:yyyyMMdd_HHmmss}.bin");
            
            File.Delete(tempFile);
        };
    }
}

5. 部署与维护方案

5.1 ClickOnce自动更新配置

在Visual Studio中设置发布属性：

1. 项目属性 → 发布 → 更新 → 设置"应用程序应检查更新"为"每次运行时"
2. 指定更新URL为内网Web服务器路径
3. 设置最低必需版本为当前版本号

5.2 日志收集策略

使用NLog配置分级日志：

xml复制<nlog>
  <targets>
    <target name="file" xsi:type="File" 
            fileName="${basedir}/logs/${shortdate}.log"
            layout="${longdate}|${level}|${message}"/>
    <target name="ftpErrors" xsi:type="File"
            fileName="${basedir}/logs/ftp_errors.log"
            layout="${longdate}|${message}"/>
  </targets>
  <rules>
    <logger name="*" minlevel="Info" writeTo="file"/>
    <logger name="FtpClient" minlevel="Warn" writeTo="ftpErrors"/>
  </rules>
</nlog>

5.3 性能计数器监控

添加自定义性能计数器：

csharp复制public class PerfCounters
{
    public static readonly string CategoryName = "FTP Client";
    
    public static void SetupCounters()
    {
        if (!PerformanceCounterCategory.Exists(CategoryName))
        {
            var counters = new CounterCreationDataCollection {
                new CounterCreationData(
                    "Active Transfers", 
                    "Number of currently active file transfers", 
                    PerformanceCounterType.NumberOfItems32),
                new CounterCreationData(
                    "Bytes Transferred/sec", 
                    "Transfer throughput in bytes per second", 
                    PerformanceCounterType.RateOfCountsPerSecond32)
            };
            
            PerformanceCounterCategory.Create(
                CategoryName,
                "FTP Client Performance Metrics",
                PerformanceCounterCategoryType.MultiInstance,
                counters);
        }
    }
    
    public PerformanceCounter ActiveTransfersCounter { get; }
    public PerformanceCounter BytesPerSecCounter { get; }
    
    public PerfCounters(string instanceName)
    {
        ActiveTransfersCounter = new PerformanceCounter(
            CategoryName, 
            "Active Transfers", 
            instanceName, 
            false);
            
        BytesPerSecCounter = new PerformanceCounter(
            CategoryName,
            "Bytes Transferred/sec",
            instanceName,
            false);
    }
}

在传输过程中更新计数器：

csharp复制public void DownloadFileWithMetrics(string remotePath, string localPath)
{
    _perfCounters.ActiveTransfersCounter.Increment();
    
    try 
    {
        long bytesTransferred = 0;
        var stopwatch = Stopwatch.StartNew();
        
        DownloadFile(remotePath, localPath, progress => {
            bytesTransferred = ...; // 计算本次传输字节数
            _perfCounters.BytesPerSecCounter.IncrementBy(bytesTransferred);
        });
    }
    finally 
    {
        _perfCounters.ActiveTransfersCounter.Decrement();
    }
}