Office部署工具提示“正在准备”卡住怎么办？

Question

在使用Microsoft Office 部署工具（Office Deployment Tool, ODT）时，用户常遇到“正在准备”界面长时间卡住的问题。该问题通常出现在配置自定义安装过程中，即使网络正常且配置文件无误，部署工具仍无法进入下一步。可能原因包括：下载源服务器响应缓慢、本地缓存损坏、防病毒软件拦截网络请求，或XML配置文件中版本/通道设置错误。此外，系统时间不准确或代理设置异常也会导致连接超时。此问题严重影响批量部署效率，需结合日志分析与环境排查快速定位根源。

Answer 1

1. 问题现象与初步排查

在使用 Microsoft Office 部署工具（Office Deployment Tool, ODT）进行自定义安装时，用户常遇到“正在准备”界面长时间卡住的问题。该界面通常出现在启动 setup.exe 并加载配置文件后，系统未能进入下载或安装阶段。

• 网络连接正常，但部署进程无响应
• 任务管理器中 setup.exe 占用 CPU 较低，无明显活动
• 多次重试仍无法突破此阶段

初步判断应从环境基础入手，检查是否因系统时间、代理设置或防火墙策略导致连接超时。

2. 常见原因分类与优先级排序

优先级	可能原因	影响范围	检测方式
高	本地缓存损坏	单机/批量失败	检查 C:\Program Files\Common Files\Microsoft Shared\ClickToRun 文件夹
高	防病毒软件拦截 HTTPS 请求	广泛存在	临时禁用杀毒软件测试
中	XML 配置中 Channel 设置错误	版本不匹配	验证 <Channel> 是否为 Monthly, SemiAnnual 等有效值
中	系统时间偏差超过 5 分钟	TLS 握手失败	w32tm /query /status
低	ODT 工具版本过旧	兼容性问题	对比微软官网最新 release 版本

3. 深度分析：日志文件定位核心瓶颈

ODT 的核心日志位于：

C:\ProgramData\Microsoft\Office\ClickToRun\Logs\<日期时间戳>.txt

关键日志片段示例：

[04-15 10:23:01] Download failed: WinHttpSendRequest. Error Code: 0x2ee2
[04-15 10:23:01] Failed to connect to officecdn.microsoft.com
[04-15 10:23:01] Proxy setting detected: AUTO (WPAD)

上述日志表明请求被阻断于 WinHTTP 层，常见于企业代理或 DNS 污染场景。

4. 解决方案路径图（Mermaid 流程图）

graph TD A["启动 ODT 安装程序"] --> B{是否卡在'正在准备'?} B -- 是 --> C[检查系统时间和时区] C --> D[验证代理设置与 PAC 脚本可达性] D --> E[关闭第三方 AV 软件] E --> F[清除 ClickToRun 缓存目录] F --> G[重新运行 setup.exe /configure config.xml] G --> H{是否成功?} H -- 否 --> I[启用诊断模式: /download debug.xml] I --> J[抓包分析 TLS 握手过程] J --> K[联系网络团队排查 SNI 过滤]

5. XML 配置陷阱与最佳实践

以下是一个典型错误配置片段：

<Configuration> <Add SourcePath="\\server\office" ...> <!-- 错误：Channel 值拼写错误 --> <Channel>Monthyl</Channel> </Add> </Configuration>

正确做法是确保 Channel 值符合官方规范：

• Monthly Enterprise
• SemiAnnual
• Current
• Targeted

同时建议显式指定 Version 和 OfficeClientEdition：

<Configuration> <Add OfficeClientEdition="64" Channel="SemiAnnual"> <Product ID="O365ProPlusRetail"> <Language ID="zh-CN" /> </Product> </Add> <Updates Enabled="TRUE" Channel="SemiAnnual" /> </Configuration>

6. 批量部署优化建议

针对大规模部署场景，推荐采用以下策略：

1. 预先下载完整镜像至本地共享路径：setup.exe /download config.xml
2. 使用组策略对象（GPO）推送预缓存后的安装包
3. 在 SCCM 或 Intune 中封装为应用程序，并附加日志采集脚本
4. 设置专用 DNS 解析规则以绕过 CDN 地域限制
5. 对 Windows Update Medic Service 进行服务依赖项校验
6. 启用 ODT 的诊断参数：--verbose --forceappshutdown
7. 定期更新 ODT 工具本身至最新版本（目前为 v17.0+）
8. 监控 TCP 80/443 出站连接状态，排除中间设备 QoS 限速
9. 配置备用源地址如 office.com、microsoft.com、ajax.aspnetcdn.com
10. 建立内部 Content Delivery Network（CDN）镜像节点