如何将Flutter应用连接至Windows Server 2019实现文件与文件夹获取

核心思路：通过中间层或标准协议交互 #

Flutter本身没有直接对接Windows Server SMB协议的原生API，最稳妥的是两种方向：搭建Web API中间层（安全可控） 或 通过第三方包直接访问SMB共享（适合简单场景），以下是详细实现方案：

方案一：搭建Web API中间层（推荐） #

通过在Windows Server上部署轻量Web服务（比如ASP.NET Core Web API）统一处理文件访问逻辑，对跨平台Flutter应用友好，且权限、安全可控。

步骤与代码示例

1. Windows Server端编写API接口
   实现文件列表查询、文件下载功能，同时加入身份验证与路径校验：

   [ApiController]
   [Route("api/files")]
   public class FilesController : ControllerBase
   {
       // 服务器共享目录根路径
       private readonly string _rootDir = @"D:\ServerSharedFiles";
   
       // 获取文件/文件夹列表
       [HttpGet("list")]
       [Authorize]
       public IActionResult GetFileList(string subPath = "")
       {
           var targetPath = Path.Combine(_rootDir, subPath);
           if (!Directory.Exists(targetPath)) return NotFound("指定路径不存在");
   
           var dirInfo = new DirectoryInfo(targetPath);
           // 整理文件信息
           var files = dirInfo.GetFiles().Select(f => new {
               Name = f.Name,
               Type = "file",
               Size = f.Length,
               LastModified = f.LastWriteTime
           });
           // 整理文件夹信息
           var dirs = dirInfo.GetDirectories().Select(d => new {
               Name = d.Name,
               Type = "directory",
               LastModified = d.LastWriteTime
           });
   
           return Ok(files.Concat(dirs));
       }
   
       // 文件下载接口
       [HttpGet("download")]
       [Authorize]
       public IActionResult DownloadFile(string filePath)
       {
           var fullPath = Path.Combine(_rootDir, filePath);
           if (!System.IO.File.Exists(fullPath)) return NotFound("文件不存在");
   
           var fileStream = new FileStream(fullPath, FileMode.Open);
           return File(fileStream, MimeTypes.GetMimeType(fullPath), Path.GetFileName(fullPath));
       }
   }
   

2. Flutter端调用API
   使用dio包发送请求，处理身份验证与数据解析：

   import 'package:dio/dio.dart';
   
   class ServerFileManager {
     final Dio _dio = Dio(BaseOptions(
       baseUrl: 'https://your-server-ip:5000/api',
       headers: {'Authorization': 'Bearer your-jwt-token'},
     ));
   
     // 获取文件列表
     Future<List<dynamic>> fetchFileList(String subPath) async {
       try {
         final response = await _dio.get(
           '/files/list',
           queryParameters: {'subPath': subPath}
         );
         return response.data;
       } catch (e) {
         throw Exception('获取列表失败：${e.toString()}');
       }
     }
   
     // 下载文件到本地
     Future<void> downloadFile(String filePath, String localSavePath) async {
       try {
         await _dio.download(
           '/files/download',
           localSavePath,
           queryParameters: {'filePath': filePath},
         );
       } catch (e) {
         throw Exception('下载失败：${e.toString()}');
       }
     }
   }
   

安全要点

• 强制启用HTTPS：在Windows Server上配置SSL证书，避免明文传输敏感数据。
• 严格身份验证：使用JWT或OAuth2，禁止匿名访问敏感目录。
• 路径校验：API层限制只能访问指定根目录，防止目录遍历攻击。

方案二：直接通过SMB协议访问 #

如果不想搭建中间层，可使用第三方包直接访问Windows Server的SMB共享目录。

可用包与代码示例

使用smbclient包跨平台访问SMB共享：

import 'package:smbclient/smbclient.dart';
import 'package:flutter_secure_storage/flutter_secure_storage.dart';

Future<void> accessSmbShare() async {
  final storage = FlutterSecureStorage();
  // 从安全存储读取账号密码，避免硬编码
  final username = await storage.read(key: 'smb_username');
  final password = await storage.read(key: 'smb_password');

  try {
    // 建立SMB连接
    final session = await SmbClient.connect(
      url: 'smb://your-server-ip/SharedFolder',
      username: username!,
      password: password!,
    );

    // 获取目录下文件列表
    final items = await session.listDirectory('');
    for (var item in items) {
      print('${item.name} - ${item.isDirectory ? "目录" : "文件"}');
    }

    // 下载文件到本地
    await session.downloadFile(
      remotePath: 'report.docx',
      localPath: '/sdcard/Downloads/report.docx',
    );

    await session.close();
  } catch (e) {
    print('SMB访问出错：${e.toString()}');
  }
}

注意事项

• 服务器配置：确保Windows Server的SMB共享目录对指定账号开放读取权限，防火墙开放445端口。
• 安全存储：账号密码需用flutter_secure_storage等加密存储，禁止硬编码。
• 兼容性：部分平台（如iOS）对SMB协议的支持可能有限，需提前测试。

潜在挑战与应对 #

1. 跨平台兼容性：Web API方案适配所有Flutter支持的平台；SMB方案需针对不同平台做兼容性测试，部分移动平台可能存在权限限制。
2. 大文件传输：Web API可实现断点续传；SMB协议在网络不稳定时易中断，需添加重试与断点续传逻辑。
3. 网络与防火墙：Windows Server防火墙需开放Web API端口（如5000）或SMB端口（445），公网访问需配置端口转发或使用VPN。

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