如何使用安装日志排查 Office 中的安装问题
本分步文章介绍如何使用 Microsoft Office 安装日志文件来排查 Office 安装程序问题。
有时 Office 安装程序出现问题，你可能不会收到错误消息。 即使收到错误消息，也可能必须使用安装日志文件作为工具之一来确定问题。
本文讨论几种解释 Office 安装日志文件中信息的技术。 主题按你希望使用每种技术的顺序列出。 本文未涵盖可能遇到的每一种情况，但讨论了通过解释安装程序日志文件解决安装程序问题的几个示例。
Microsoft 知识库中与安装错误相关的许多文章还包括日志文件部分，可帮助你确认本文描述你遇到的相同问题。
如何创建日志文件
Office 安装程序会自动在 \Temp 文件夹中创建日志文件。 对于登录或激活问题，日志将存储在 %temp% 下。 对于安装或修补问题，它们使用系统帐户，因此你还需要从 %windir%\temp 收集日志。有关详细信息，请参阅如何启用Microsoft 365 企业应用版 ULS 日志记录。
| 的日志文件 | 日志文件名 |
|---|---|
| Setup.exe | Microsoft Office 安装程序 (####) .txt |
| Windows Installer (系统文件更新) | Microsoft Office 安装程序 (####) _Task (0001) .txt |
| Windows Installer (Office 安装) | Microsoft Office 安装程序 (####) _Task (0002) .txt |
日志文件名称中的 #### 字符是以 0001 开头的数字。 每次运行安装程序时，它们都会递增 1。 因此，具有最大数目的日志文件是最近运行安装程序的时间的日志文件。
注意
你可能只有 Office 安装的 Microsoft Windows Installer 日志文件。 在这种情况下，Office 安装的 Windows Installer 日志文件将 Task (0001) 追加到日志文件，而不是任务 (0002) 。
如何解释日志文件
根据遇到的问题，可能需要查看 Office 安装的安装程序日志文件或 Windows Installer 日志文件。
安装日志文件
Setup.exe 文件的日志文件非常短，因为 Setup.exe 执行的任务数仅限于如下所示的任务：
读取 Setup.ini 文件。
分析必须传递给 Windows Installer 的属性和开关的命令行。 一个常见错误是包含在
Transform=<path>\<transform file name>.mst命令行中。 在命令行上使用它不会在安装过程中生成错误消息，但转换不会应用于安装。 正确的命令行是Transforms=<path>\<transform file name>.mst。Setup.exe 日志文件包含为安装指定的命令行，因此必须检查日志文件中出现拼写错误，例如上一个示例中所示的， (第一个命令行) 的 Transform 末尾缺少字母 。
验证是否使用了正确的操作系统和服务包。
检查 Msi.dll 文件的版本。
启动 Instmsi (w) .exe 文件以安装 Windows 安装程序。
检查已安装的 Office beta 版本。
检查 Tahoma 和 TahomaBD 字体的版本。
默认情况下，安装程序在 Office 中创建本地安装源，但仅当从 CD 或压缩的 CD 映像安装 Office 时。 如果本地计算机上有足够的硬盘空间，则安装程序默认缓存整个安装源。 Windows Installer 使用此本地安装源来安装 Office，并且本地源仍可用于稍后修复、重新安装或更新 Office。 用户可以按需安装功能，或在维护模式下运行安装程序来添加新功能。 由于安装程序默认创建本地安装源，因此无需设置任何其他选项。 安装程序在用户计算机上的以下隐藏文件夹中创建本地安装源：
<drive>\Msocache\Downloadcode
默认情况下，安装程序在 Office 中缓存整个源。 如果用户的计算机没有足够的磁盘空间，安装程序将只缓存所选功能的安装文件。 安装完成后，安装程序会保留本地安装源。
安装日志中可能包含以下信息：
要复制到 \MSOCACHE 文件夹的文件列表：要下载的文件：
File: FILES\WINDOWS\INF\AER_1033.ADM (DW20.ADM_1033) File: FILES\PFILES\COMMON\MSSHARED\DW\DW20.EXE (DW20.EXE_0001) File: FILES\PFILES\COMMON\MSSHARED\DW\DWDCW20.DLL (DWDCW20.DLL) File: FILES\PFILES\COMMON\MSSHARED\DW\1033\DWINTL20.DLL (DWINTL20.DLL_0001_1033) File: FILES\PFILES\COMMON\MSSHARED\DW\DWTRIG20.EXE (DWTRIG20.EXE) File: FILES\PFILES\MSOFFICE\OFFICE11\OCLEAN.DLL (OCLEAN.DLL_1033) File: FILES\PFILES\MSOFFICE\OFFICE11\OCLNCORE.OPC (OCLNCORE.OPC_1033) File: FILES\PFILES\MSOFFICE\OFFICE11\OCLNCUST.OPC (OCLNCUST.OPC_1033) File: FILES\PFILES\MSOFFICE\OFFICE11\1033\OCLNINTL.OPC (OCLNINTL.OPC_1033) File: FILES\PFILES\MSOFFICE\OFFICE11\OFFCLN.EXE (OFFCLN.EXE_1033) File: FILES\SETUP\OSE.EXE (OSE.EXE) File: PRO11.MSI (PRO11.MSI) File: FILES\PFILES\MSOFFICE\OFFICE11\1033\PSS10O.CHM (PSS10O.CHM_1033) File: FILES\PFILES\MSOFFICE\OFFICE11\1033\PSS10R.CHM (PSS10R.CHM_1033) File: FILES\PFILES\MSOFFICE\OFFICE11\1033\SETUP.CHM (SETUP.CHM_1033) File: SKU011.XML (SKU011.XML_0002_1033) File: A2561405.CAB (A2561405.CAB) File: A3561405.CAB (A3561405.CAB) File: A4561405.CAB (A4561405.CAB) File: AV561403.CAB (AV561403.CAB) File: CC561401.CAB (CC561401.CAB)确认本地安装源设置：
Using Local Cache Drive of already installed product: C:\. Found enough space on drive "C:\" to cache all feature cabinets. (CDCACHE=AUTO) - There is enough space to cache some or all of the image. Drive for this download is C:\确认已完成的任务：
Package was: E:\5614.0_o11pro_CBXS_ENG\PRO11.MSI. Setting Package to: C:\MSOCache\All Users\90000409-6000-11D3-8CFE-0150048383C9\PRO11.MSI. Done with CD Caching, cached MSI to: C:\MSOCache\All Users\90000409-6000-11D3-8CFE-0150048383C9\PRO11.MSI
如果怀疑正在使用的命令行属性和开关出现问题，这些项也会在安装程序日志文件中列出。 例如，如果使用以下命令行来运行安装程序：
f:\Setup.exe companyname="contoso" /qb
安装日志中包含以下文本：
Launch Setup
9/22/03 1:49:46 PM
companyname="contoso" /qb
Detected Windows Info:
PlatformId = 2
MajorVersion = 4
MinorVersion = 0
Setup path: \\server\share\2003_Admin\SETUP.EXE
Adding property...companyname="contoso"
Recognized command line switch: /qb -and-Office-specific properties added: companyname="contoso"
General properties added: LAUNCHEDFROMSETUP=1 SETUPEXEPATH=\\server\share\2003_Admin\
Writing Task:
D:\WINNT\System32\msiexec.exe
/I \\server\share\2003_Admin\PRO11.MSI
METRICSSOURCE="\\server\share\2003_Admin companyname=""contoso"" /qb"
companyname="contoso" LAUNCHEDFROMSETUP=1
SETUPEXEPATH=\\server\share\2003_Admin\ /qb
注意
Setup.exe 实际上并不使用这些命令行开关和属性。 它只需将它们传递到 Windows Installer) (Msiexec.exe 文件。
如果 Setup.exe 的日志文件以类似于以下 (返回代码的文本结尾：1603) ，则安装中的 Windows Installer 部分出现问题：
9/22/03 3:34:27 PM Chained install return code: 1603
Shutting down chained setup processing.
Set Verbose logging for subsequent setup.
***** Setup exits
9/22/03 3:34:27 PM
(return = 1603)
在这种情况下，必须查看 Office 安装的 Windows Installer 日志文件。
Windows Installer 日志文件
Windows Installer 日志文件明显大于安装程序日志文件，最初可能看起来不可读。 但是，以下准则可帮助你缩小问题的范围：
如果在安装过程中收到一个错误消息，可在日志文件中搜索错误编号。 例如，如果在安装过程中收到“错误 1327”，请在日志中搜索“1327”。 你可能会发现类似于以下示例的文本：
MSI (c) (41:90): Note: 1: 1327 2: C:\ Error 1327. Invalid Drive: C:\ MSI (c) (41:90): Product: System Files Update -- Error 1327. Invalid Drive: C:\ Action ended 15:34:26: CostFinalize. Return value 3.这些日志条目中的键文本为 “驱动器无效”。 在这种情况下，问题在于你使用了磁盘管理员等实用工具来更改 Windows 安装位置的驱动器号。 尽管驱动器号已更改，但某些注册表项仍引用原始驱动器号。
如果 Microsoft 知识库中没有与特定错误消息匹配的文章，请执行以下步骤来诊断问题：
搜索日志文件中的错误编号。
从带有错误号的行中读取每一行。 通常您会看到表示失败的行，该行的最终结果是安装错误。
例如，在日志文件中搜索了“错误 2737”。 以下文本位于行或行上方，出现 2737 错误：
MSI (c) (B7:A7): Note: 1: 2737 2: CheckCAServer 3: c:\windows\TEMP\MSI82D6.TMP 4: CheckCAServer Info 2898. An internal error has occurred. (Tahoma8 Tahoma 1) Error 2737. An internal error has occurred. (CheckCAServer c:\windows\TEMP\MSI82D6.TMP CheckCAServer ) MSI (c) (B7:A7): Product: Microsoft Office Professional 2003 -- Error 2737. An internal error has occurred. (CheckCAServer c:\windows\TEMP\MSI82D6.TMP CheckCAServer ) Action ended 9:58:55: CheckCAServer. Return value 3.查看此文本，可以看到安装程序在调用 CheckCAServer 时失败。
所有日志文件都包含一个或多个通常可以忽略的错误。 以下错误可能出现在任何日志文件中，通常并不表示存在安装程序问题：
- 信息 2898。 发生内部错误。 请联系你的信息技术部门寻求帮助。
- 信息 2743。 发生内部错误。 请联系你的信息技术部门寻求帮助。
- 信息 2726。 发生内部错误。 请联系你的信息技术部门寻求帮助。
要搜索的一件事是字符串“Note”。 在安装程序失败并出现 2755 错误的情况下，该案例的实际解决方法派生自错误上方的几行注释：
MSI (s) (EC:BC): Note: 1: 2336 2: 5 3: C:\WINNT\Installer\ MSI (s) (EC:BC): MainEngineThread is returning 1632 MSI (c) (F8:F4): Note: 1: 2755 2: 1632 3: \\server\share\2003_Admin\PRO11.MSI Error 2755. An internal error has occurred. (1632 \\server\share\2003_Admin\PRO11.MSI) Contact your Information Technology department for assistance.在此示例中，以下两行表示 \Winnt\Installer 文件夹的权限存在问题：
MSI () (EC：BC) ：注意：1：2336 2：5 3：C：\WINNT\Installer\
MSI () (EC：BC) ：MainEngineThread 返回 1632更正此文件夹的权限后，未发生 2755 错误。
注意
包含“1632”的行是此问题处理权限的决定因素。
在包含 Note 的日志条目中， Note 后面的四位数可以直接映射到本文前面引用的知识库文章中列出的 Windows Installer 错误。
要在日志文件中搜索的另一个字符串是 返回值 3。 如果你没有或没有记住错误编号，但在日志文件中找到了 “返回值 3 ”，则这是重点排查问题的区域。 在安装过程中执行操作时，日志文件中会记录该操作。 该操作完成后，随后会记录一个返回值。 如果返回值为 1，则表示操作成功。 如果操作失败，则返回值为 3。
Action start 9:56:45: SetW2kMill_WFP. Action ended 9:56:45: SetW2kMill_WFP. Return value 1. MSI (c) (B7:A7): Doing action: CheckCAServer Action start 9:56:45: CheckCAServer. MSI (c) (B7:A7): Creating MSIHANDLE (3) of type 790542 for thread -183129 MSI (c) (B7:A7): Closing MSIHANDLE (3) of type 790542 for thread -183129 MSI (c) (B7:A7): Note: 1: 2737 2: CheckCAServer 3: c:\windows\TEMP\MSI82D6.TMP 4: CheckCAServer Info 2898. An internal error has occurred. (Tahoma8 Tahoma 1 ) Error 2737. An internal error has occurred. (CheckCAServer c:\windows\TEMP\MSI82D6.TMP CheckCAServer ) MSI (c) (B7:A7): Product: Microsoft Office Standard 2003 -- Error 2737. An internal error has occurred. (CheckCAServer c:\windows\TEMP\MSI82D6.TMP CheckCAServer ) Action ended 9:58:55: CheckCAServer. Return value 3.在这种情况下，SetW2kMill_WFP操作成功，因为返回值为 1。 但是，下一个操作 CheckCAServer 将失败，因为它的返回值为 3。
有时，查看日志文件时，找不到“Note”、“Return Value 3”或错误号。 相反，你可能会看到类似于以下示例的文本：
MSI (c) (A5:65): Looking for file transform: c:\test.mst MSI (c) (A5:65): Note: 1: 2203 2: c:\test.mst 3: -2147287038 MSI (c) (A5:65): Couldn't find cached transform c:\test.mst. Looking for it at the source. MSI (c) (A5:65): Looking for file transform: \\server\share\2003_ADMIN\test.mst MSI (c) (A5:65): Note: 1: 2203 2: \\server\share\2003_ADMIN\test.mst 3: -2147287038 MSI (c) (A5:65): Note: 1: 2729 1: 2203 2: \\server\share\2003_ADMIN\test.mst 3: -2147287038 Error applying transforms. Verify that the specified transform paths are valid. \\server\share\2003_ADMIN\test.mst MSI (c) (A5:65): MainEngineThread is returning 1624在这种情况下，安装程序在应用转换时出现问题，因为转换不能位于 C：\test.mst) (指定路径上。 因此，安装程序还会尝试在 Office 源位置的根目录中查找转换。 当转换不能位于任一位置时，安装将停止。
详细日志文件
Windows Installer 日志文件部分中列出的所有技术都可以用于详细日志文件。 但是，详细日志记录会增加安装时间。 仅当遇到无法使用默认日志文件诊断的安装程序问题时，才使用详细日志记录。
生成详细日志文件
在 Office 的初始安装中，不使用详细日志记录。 如果安装失败，第二次尝试安装将生成详细日志文件。 但是，用于这些详细日志文件的日志记录选项并不是 Windows 安装程序可用的所有选项。 若要创建包含所有日志记录选项的更详细的 Windows Installer 日志文件，可以将 *v 参数组合用于 /L 开关。
注意
使用如下所示的命令行执行 Office 管理安装时，可以创建详细日志文件：
<path>\setup.exe /a <path>\Pro11.msi /L*v C:\Verboselog.txt诊断安装程序何时停止响应
有时，Office 安装程序停止响应 (挂起) ，并且你不会收到任何错误消息。 在这种情况下，最好的做法是重启计算机，并再次运行 Office 安装程序，并启用完整的详细日志记录 (，) 一个附加选项。 为此，请执行以下步骤：
单击“开始”，然后单击“运行”。
在 “打开 ”框中，键入以下命令行，然后单击“ 确定”：
<path>\Setup.exe /L*v! C:\Verboselog.txt此处 <路径> 是 Office 源位置的完整路径。
通常，19 行日志记录信息在写入详细日志文件之前缓存在内存中。 如果不使用 ！ 选项为 /L (日志记录) 切换，如果安装程序停止，可能会丢失一些缓存的信息或所有缓存的信息。 如果使用 ！ 选项，你损失最多的是一行，因为 ！ 选项强制安装程序一次将日志记录信息写入日志文件一行， (没有缓存) 的信息。
创建详细日志文件后，滚动到末尾并查看最后一行或两行。 这些行指示安装程序在停止时尝试执行的操作。 例如，你可能会看到类似于以下示例的文本：
ComponentRegister(ComponentId={71CE92CC2CB71D119A12000A9CE1A22A}, KeyPath=C:\Program Files\Common Files\Microsoft Shared\Web Components\11\1033\OWCDCH11.CHM,State=3,,Disk=1,SharedDllRefCount=0) 1: {90170409-6000-11D3-8CFE-0050048383C9} 2: {71CE92CC2CB71D119A12000A9CE1A22A} 3: C:\Program Files\Common Files\Microsoft Shared\Web Components\11\1033\OWCDCH11.CHM这表明 Windows 注册表) 组件 (71CE92CC2CB71D119A12000A9CE1A22A) （其密钥路径为 OWCDCH11.CHM）的 Windows 注册表 (存在问题。
此特定问题的解决方法是在再次运行 Office 安装程序之前修复 Windows 注册表。
在另一种情况下，可能会在日志文件中看到类似于以下示例的文本：
MSI (c) (EB:1F): Doing action: OPCRemove Action start 11:42:57: OPCRemove. MSI (c) (EB:1F): Creating MSIHANDLE (504) of type 790542 for thread -194273这表示 Office 删除向导操作存在问题。 当 Office 安装程序在删除早期版本的 Microsoft Office 时遇到问题时，可能会出现此问题。 尝试删除早期版本的 Office，然后再次运行 Office 2003 安装程序。
注意
Office 安装程序对自定义操作使用以下前缀。 如果日志文件指示自定义操作存在问题，则这些前缀指示从何处开始进行故障排除。
- OLCA：Outlook 自定义操作
- OPC：Office 删除向导
- CAG、CaMMC：与剪辑关联
- IE：Internet Explorer
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈