MSI 安裝出現 Error 1603 怎麼辦?Windows Installer 完整排查

⚡ 站長快讀:核心重點

• 文章屬性:疑難排除
• 適用系統:Windows 11、Windows 10
• 難易度 / 耗時:★★☆ / 約 20–40 分鐘(站長估計)
• 核心結論:MSI 安裝 Error 1603 是總結碼,只說明「安裝過程發生致命錯誤」,真正原因要到詳細記錄檔裡找。
• 適用對象:安裝 .msi 時看到 1603(或 0x643)、安裝被回復的人

📌 快速答案

一句話答案:MSI 安裝 Error 1603 在排除已安裝同一程式後,用 msiexec /i "安裝檔" /L*V "記錄檔" 重跑一次,再用記事本搜尋第一個 Return value 3,從那一行往上讀出失敗的動作後對症處理。

– 微軟官方列出四種成因:同一程式已安裝、目標資料夾被加密、目標位於 subst 虛擬磁碟、SYSTEM 帳戶對目標資料夾沒有完全控制權限

– 若同一程式已在「已安裝的應用程式」清單中,先解除安裝再重裝

🧰 開始前的準備

• 適用系統:Windows 11、Windows 10(微軟 1603 疑難排解文件標示適用 Windows 10 與支援中的 Windows Server;錯誤碼表未標示適用版本)
• 權限需求:系統管理員(需要以系統管理員身分執行命令提示字元、修改資料夾權限)
• 需要工具:命令提示字元(msiexec 為 Windows 內建)、記事本、事件檢視器;不需下載第三方工具
• 預計耗時:約 20–40 分鐘(站長估計)
• 先備份:修改任何資料夾權限前,先把「安全性」分頁目前的權限清單截圖存檔;正式使用中的電腦建議先建立系統還原點
• 停止條件(符合任一請先停手):公司或學校管理的電腦且沒有 IT 授權;安裝檔來源不明;記錄檔指出的失敗點與本文描述的成因都對不上;你無法確定該改哪個資料夾的權限

🔍 症狀描述與錯誤訊息

安裝 .msi 時,進度條跑到一半或接近結尾,跳出錯誤對話框。微軟官方文件記載的原文如下:

Error 1603: A fatal error occurred during installation.

依微軟說明,在這個訊息框按下「確定」後,安裝會被回復(roll back)。中文介面的譯文依安裝程式而異,判斷時以錯誤碼 1603 為準。

1603 還常以另外兩種形式出現,兩者指的都是同一個錯誤。

• 安裝程式自己的記錄檔:用 setup.exe 包裝 MSI 的安裝程式也會記下這個錯誤,例如 Office 的 setup.exe 記錄會寫成 ErrorCode: 1603(0x643)。0x643 就是十進位 1603 的十六進位寫法,兩者是同一個錯誤。
• 事件檢視器:Windows Installer 會把安裝結果寫進「Windows 記錄 → 應用程式」。失敗時可看到事件識別碼 11708(Installation operation failed),以及事件 1033 的訊息「Installation completed with status」欄位所帶出的結束狀態碼。

如果你看到的是 1618(另一個安裝正在進行)、1638(已安裝其他版本)或 1632(Temp 資料夾已滿或無法存取),那是 Windows Installer 已經幫你分類好的錯誤,直接照該錯誤碼處理即可,不必套用本文的 1603 流程。

🔎 問題根因

1603 的正式名稱是 ERROR_INSTALL_FAILURE,微軟錯誤碼表對它的描述只有一句「安裝期間發生致命錯誤」,沒有任何成因資訊。

所以同一個 1603 背後可能是完全不同的問題。微軟 Office 安裝排錯文件裡的實例就很典型:一例是安裝套件的自訂動作(Custom Action)在寫入事件記錄設定時被拒絕存取,記錄檔寫著「CustomAction RegisterEventManifest returned actual error code 1603」;另一例則是記憶體不足導致安裝程式提前終止,記錄檔結尾寫著「MainEngineThread is returning 1603」。兩者成因毫無關聯,對外報出的卻都是 1603。

微軟 1603 疑難排解文件針對一般安裝情境列出的成因共有四種。

• Windows Installer 試圖安裝一個電腦上已經裝好的程式
• 安裝目標資料夾被加密
• 目標資料夾所在的磁碟機是以 subst 虛擬磁碟方式存取
• SYSTEM 帳戶對目標資料夾沒有完全控制權限

這四項以外的成因(自訂動作失敗、檔案被占用、磁碟空間不足等),主要靠詳細記錄檔找出來(檔案占用這類情況在事件檢視器也看得到)。【站長判斷】這也是本文把「產生記錄檔」放在第二步、放在改權限與換安裝路徑這類修改系統設定的動作之前的原因:沒看到記錄檔就改權限、重灌 Windows Installer,等於在猜。

🔬 底層機制:這個錯誤訊號從哪裡來?

Windows Installer 是以交易方式執行安裝的服務,每個動作都會回報結果,任一關鍵動作失敗就整筆回復,最後對外只交出一個總結碼。 拆開來看有三層:

第一層:安裝實際由 SYSTEM 帳戶執行。 微軟文件說明,Windows Installer 服務是用 SYSTEM 帳戶來安裝軟體。這解釋了一個常見困惑:你登入的帳號是系統管理員,檔案總管也能正常寫入該資料夾,安裝卻仍然因權限失敗,因為真正寫檔的是 SYSTEM,檢查權限時要看的是 SYSTEM 那一列。

第二層:每個動作都有回傳值。 詳細記錄檔會逐一記下每個安裝動作的結束狀態,格式類似「Action ended 時間: InstallExecute. Return value 3.」。依微軟文件,回傳值 1 代表成功、2 代表取消、3 代表錯誤;正常完成的安裝通常不會出現 value 3。

第三層:失敗後回復,再回報總結碼。 一旦關鍵動作回傳 3,Windows Installer 會回復整筆安裝,最後回報 1603 這類總結錯誤碼(微軟範例中也有回報 1601 的情形)。事件檢視器裡,Error 表中一般錯誤的事件識別碼等於錯誤號碼加上 10,000,例如成功訊息 1707 會記成事件 11707;1033、1025 這類事件則另有固定編號。

🛠️ 解決方案

方法三會修改資料夾權限。動手前請先截圖保存原本的權限設定,公司或學校管理的電腦請先取得 IT 授權。

方法一:先排除「已經裝過」與「別的安裝還在跑」

成本最低的檢查是確認這個程式是不是已經在電腦上,這也是微軟列出的第一種成因。

1. 開啟「設定 → 應用程式 → 已安裝的應用程式」(微軟 1603 文件列出的 Windows 10 路徑為「設定 → 系統 → 應用程式與功能」),搜尋要安裝的程式名稱。
2. 如果清單中已經有它(版本相同或不同都算),先選它並執行「解除安裝」,完成後再執行新的安裝檔。
3. 如果程式有「進階選項」,微軟也建議可先試「修復」或「重設」;並非所有桌面程式都提供這兩個選項。

同時確認沒有另一個安裝正在背景執行。依微軟錯誤碼表,另一個安裝進行中時 Windows Installer 會回報 1618,必須等它完成才能繼續。最簡單的清場方式是依微軟建議先重新啟動電腦,再只執行這一個安裝檔。

方法二:用 msiexec 產生詳細記錄檔,定位失敗點

這一步不修改系統,只產生一份文字記錄檔,是找出真正成因的關鍵。 執行前先確認 C:\Temp 資料夾存在(沒有就在檔案總管的 C 槽新增一個 Temp 資料夾),否則記錄檔無法建立。接著以系統管理員身分開啟命令提示字元,把路徑換成你的安裝檔:

msiexec /i "C:\Temp\app.msi" /L*V "C:\Temp\app_install.log"

參數意義(依微軟 msiexec 文件):/i 是一般安裝;/L* 記錄除了詳細輸出與額外偵錯資訊以外的所有資訊,再加上 V 就把詳細輸出一起寫入,記錄檔會存到最後指定的路徑。

安裝照樣失敗之後,用記事本打開 app_install.log:

1. 按 Ctrl+F 搜尋 Return value 3。
2. 只看第一個命中的位置。 微軟文件指出記錄檔中常有不只一個 value 3,應該聚焦在最先出現的那一個。
3. 往上捲動,閱讀這一行之前的幾十行,找出是哪個動作(Action)失敗、有沒有附帶的錯誤號碼或檔案路徑。常見線索包括「Error 1304. Error writing to file」(寫入檔案失敗)、CustomAction ... returned actual error code(自訂動作失敗)、存取被拒(0x80070005)等。
4. 如果整份記錄檔找不到 value 3,微軟 Office 安裝排錯文件的建議是改找第一個 Rolling back 字樣,那裡就是開始回復的位置。

/L* 也會把「磁碟空間不足」相關訊息寫進記錄檔。若記錄檔在失敗點附近出現空間不足的訊息,先清出磁碟空間再重試。

如果你手上只有 setup.exe、沒辦法直接對 .msi 下指令,微軟另有透過登錄原則開啟全域 Windows Installer 記錄的做法(記錄檔會出現在 Temp 資料夾,檔名以 Msi 開頭)。這屬於登錄修改,微軟也提醒只在排錯期間開啟、用完就要移除,否則會影響效能與磁碟空間;需要時請照官方文件操作並先備份登錄,本文不展開。

方法三:依記錄檔對症處理微軟列出的成因

記錄檔若指向存取被拒、無法寫入目標路徑,優先檢查以下三項。

(1)SYSTEM 帳戶沒有完全控制權限。 微軟官方步驟是對目標磁碟機操作;【站長判斷】若記錄檔已指出是哪個資料夾寫不進去,只對該資料夾處理,影響範圍較小。

1. 在檔案總管對目標磁碟機或資料夾按右鍵 →「內容」→「安全性」分頁,先截圖。
2. 確認「群組或使用者名稱」清單中有 SYSTEM。沒有的話按「編輯」→「新增」,輸入 SYSTEM 後按「檢查名稱」→「確定」。
3. 選取 SYSTEM,確認「完全控制」的「允許」已勾選。
4. 回到「內容」視窗按「進階」→「變更權限」,選取 SYSTEM 項目按「編輯」,在「套用到」選「這個資料夾、子資料夾及檔案」,按確定並等待套用完成。
5. 重新執行安裝檔。

(2)目標資料夾被加密。 微軟的處置很單純:改裝到沒有加密的資料夾。

(3)目標位於 subst 虛擬磁碟。 在命令提示字元輸入不帶參數的 subst,會列出目前生效的虛擬磁碟機。

subst

如果安裝路徑的磁碟代號出現在清單中,改把安裝路徑指到它對應的實體路徑再安裝。

方法四:記錄檔指向自訂動作或檔案占用時

失敗點若是安裝套件自己的自訂動作,先把記錄檔段落交給軟體廠商判斷。 微軟錯誤碼文件本身就註明,使用者安裝或移除程式遇到困難時,應聯絡該軟體的客服。回報時附上記錄檔中第一個 Return value 3 前後的段落,對方較能判斷。

若記錄檔或事件檢視器顯示檔案正被其他程序使用(Windows Installer 事件 1025 會記下占用檔案的程序名稱與 ID),可先關閉該程式;原因不明時,可用乾淨開機暫時停用第三方服務與啟動項,確認是不是背景軟體卡住安裝。測試完記得照該文的步驟還原。

✅ 驗證修復結果

判斷是否真正修好,看三個地方。

1. 安裝流程:安裝跑完不再跳出 1603,也沒有進入回復。若回傳 3010,依微軟定義代表安裝成功但需要重新啟動電腦才能完成,屬正常結果。
2. 事件檢視器:「Windows 記錄 → 應用程式」出現事件 11707(Installation operation completed successfully)。
3. 已安裝清單:「設定 → 應用程式 → 已安裝的應用程式」(Windows 10 路徑同方法一)出現該程式,且能正常開啟。

建議保留這次的記錄檔。日後同一台電腦再出現 1603,可以直接比對兩份記錄檔的失敗點是否相同。

🔙 萬一翻車:回退步驟

• 權限改壞了:依修改前的截圖,回到「內容 → 安全性 → 編輯」把各帳戶權限恢復原狀;若 SYSTEM 原本不在清單內、是你新增的,將它移除即可。
• 安裝半途失敗:1603 發生時 Windows Installer 會自動回復該次安裝。若該程式仍出現在已安裝清單中,依方法一的路徑(Windows 11 或 Windows 10)解除安裝。
• 系統行為異常且無法判斷原因:使用動手前建立的系統還原點還原。
• 記錄檔:C:\Temp\app_install.log 只是文字檔,排錯完成後可自行刪除,不影響系統。

💡 總結:預防再次發生

預防 1603 的核心是讓安裝跑在單純的環境,並在失敗當下就留下記錄檔。 依微軟列出的成因,安裝前先確認同一程式沒有殘留、安裝路徑不在加密資料夾或 subst 虛擬磁碟上,並且不要隨意收回 SYSTEM 帳戶在系統磁碟上的權限,因為 Windows Installer 服務正是用這個帳戶寫檔。

站長的建議是把「失敗就加 /L*V 重跑一次」當成固定動作。1603 是總結碼,真正的線索只在記錄檔裡;先定位第一個 Return value 3,再決定要改權限、換路徑還是聯絡廠商,比在網路上照單全收各種修復指令更快,也更不容易把系統越修越亂。軟體安裝格式本身的差異,可以參考站上的 EXE、MSI、MSIX 格式比較。

❓ 常見問題

Q:1603 到底是什麼錯?

1603 是 Windows Installer 的通用致命錯誤碼(ERROR_INSTALL_FAILURE),意思是安裝途中發生致命錯誤而整筆回復。它不指出成因,必須看詳細記錄檔才知道是哪個動作失敗。

Q:要怎麼看安裝記錄?

以系統管理員身分執行 msiexec /i "安裝檔路徑" /L*V "記錄檔路徑",失敗後用記事本打開記錄檔,搜尋 Return value 3,從第一個命中處往上讀,就能看到失敗的動作與錯誤訊息。

Q:我是系統管理員,權限問題還會造成 1603 嗎?

會。Windows Installer 服務是用 SYSTEM 帳戶安裝軟體,要檢查的是 SYSTEM 對目標資料夾有沒有完全控制權限,跟你登入的帳號是不是系統管理員是兩回事。

Q:殘留的舊版會影響嗎?

會。微軟列出的第一種成因就是試圖安裝電腦上已經裝好的程式;另外若已安裝其他版本,Windows Installer 可能直接回報 1638。先到「已安裝的應用程式」解除安裝舊版,再裝新版。

Q:錯誤碼顯示 0x643,跟 1603 一樣嗎?

一樣。0x643 是 1603 的十六進位寫法,微軟文件中的安裝記錄範例就寫成「ErrorCode: 1603(0x643)」。

Q:修完之後又復發怎麼辦?

保留每次失敗的詳細記錄檔並比對第一個 Return value 3。失敗點相同代表根因沒有處理到;失敗點不同則可能是另一個問題。若都指向同一個廠商的自訂動作,帶著記錄檔段落聯絡該軟體客服。

🔗 延伸閱讀

• Windows 11 登錄檔備份與還原完整教學
• Program Files (x86) 是什麼?為什麼 Windows 會有兩個資料夾
• 用 WinGet + Sudo 實現軟體部署程式碼化
• Microsoft Store 打不開、App 卡在下載?WSReset 到重新註冊全解法

📎 參考資料來源

📖 第一級|廠商官方:

• Error 1603 when you try to install a Windows Installer package(Microsoft Learn) — 2026-09-24 查證
• MsiExec.exe and InstMsi.exe error messages(Microsoft Learn) — 2026-09-24 查證
• msiexec 命令參考(Microsoft Learn) — 2026-09-24 查證
• Enable Windows Installer logging(Microsoft Learn) — 2026-09-24 查證
• Event Logging (Windows Installer)(Microsoft Learn) — 2026-09-24 查證
• Troubleshooting Office installation errors(Microsoft Learn,舊版封存文件) — 2026-09-24 查證
• subst 命令參考(Microsoft Learn) — 2026-09-24 查證
• Fix problems that block programs from being installed or removed(Microsoft Support) — 2026-09-24 查證

⚠️ 本文核心事實皆取自微軟官方文件,屬官方文件查證(E3),非站長實機實測;標示「站長估計」「站長判斷」者為推論與建議。

📅 本文查證戳記:2026-09-24 依據微軟 Windows Installer 與 msiexec 官方文件查證撰寫。

若新版 Windows 的記錄檔格式或事件識別碼與本文不同,歡迎在留言區貼上對應的記錄檔段落,站長會更新文章。