Files
order-notification-automation/docs/storage-browser-timeout-2026-10-17.md
T

4.0 KiB

服务器共享浏览与连接等待修复

日期:2026-10-17。

原问题复现:StorageService.checkConnection 直接等待 Windows UNC 目录读取,未设总超时;注入永不返回的 list 可使 pendingChecks 一直保留。前端因此一直禁用检查/保存,缺少取消入口。

实现

  • 表单接受单独 IP、主机名或 \\服务器,点击“浏览”调用 Windows NetShareEnum 枚举普通磁盘共享,再进入共享与子目录。支持上一级、选择当前目录和完整 UNC 路径。
  • 服务器入口检查成功仅用于列举共享;保存仍必须选择实际可读共享目录,根入口检查不会误解锁保存。
  • 草稿检查与目录选择在独立 Node 工作进程中运行;复用原有 FileArea 的逐段路径、根目录和链接限制。服务器枚举采用 Windows 原生 NetShareEnum,受正常 SMB 权限限制,隐藏管理共享不列出。显式账号通过 IPC$ 建立同服务器认证,不自动断开已有连接。
  • 后端总等待 15 秒,外部取消和关闭表单触发终止工作进程树。若树终止失败尝试直接终止工作进程,等待退出,最后有 1.5 秒清理上限;服务关闭等待最多 1.8 秒额外清理,避免无限等待。若系统拒绝终止进程,不能保证其下游系统组件即时结束。
  • 前端检查/浏览有 18 秒等待上限及“取消操作”,输入变更取消旧请求,旧结果不影响当前表单;保存响应有 45 秒上限,避免误以为结果已确定。
  • 每次列表最多 500 项;Native 枚举输出上限 384 KiB、工作进程结果上限 512 KiB,全部有界。密码只通过管道传给工作进程,不进入命令行或返回正文。

OpenList 参考核实

检查 OpenList v4.2.7 SMB util.go 中的 Dial(ctx)、Mount(ShareName),以及 driver.go 中 List/checkConn/ReadDir 的分步流程。上游仍显式配置 ShareName,不能据此声称它本身实现了本次的服务器共享选择器。此处采用独立编写的 Windows 原生实现,未复制 AGPL 后端源码;15 秒上限是本项目的实现选择。

验证范围

  • 新增超时、取消、关闭服务、失败的 taskkill 退出后降级终止、501 个中文共享名输出上限回归。
  • HTTP 覆盖服务器根入口枚举、管理员/同源限制、根入口禁止保存、选定共享可保存;原凭据和目录限制继续回归。
  • 浏览器覆盖选择共享、进入子目录、取消/超时后恢复、重新检查和保存。
  • 现场使用本机 SMB 共享及独立临时工作台,脚本 output/verify-smb-browser.cjs,从只填127.0.0.1开始逐层选择;未向正式工作台添加测试配置。
  • 手工对独立进程强制1ms超时、主动取消,再次成功枚举本机9个共享,验证恢复能力。

边界:本次期限与进程隔离针对草稿连接检查和目录选择。已保存服务器的其他读写、下载及归档不是全部迁移至独立工作进程。服务器可能禁止枚举共享,此时仍可填写已知完整共享路径。

验证完成:

node --test --test-concurrency=2 tests/storage-browse.test.cjs tests/storage-http.test.cjs tests/storage-picker-ui.test.cjs tests/storage-ui.test.cjs tests/storage-preview-ui.test.cjs
# 12 / 12
node --test --test-concurrency=2 tests/storage-browse.test.cjs tests/storage.test.cjs tests/storage-http.test.cjs tests/storage-preview-http.test.cjs
# 较早一轮16 / 16;其中 Store 7项、preview HTTP 2项与最终轮不重复
node --test --test-timeout=200000 output/verify-smb-browser.cjs
# 实际 SMB 1 / 1

最终涉及22项独立测试全部通过,未运行全量测试集。现场临时共享目录已清理。独立审查指出并修复枚举输出缓冲不足及进程清理未观察退出两个问题,对应回归先失败后通过。截图见 output/verification/storage-server-shares.png 与 storage-browser-success.png。语法和差异空白检查通过。