解決 Tomcat 安裝為 Windows 服務後無法啟動的權限問題

問題現象

在 Windows 7/10/11 系統上，使用 service.bat install 將 Tomcat 安裝為 Windows 服務後，服務創建成功但啟動失敗，系統日誌報錯：

而直接運行 startup.bat 卻完全正常。

根因分析

核心原因：管理員權限缺失

Windows Vista 之後引入 UAC（用戶賬戶控制），即使管理員賬戶運行命令行，默認也是標準權限令牌。Tomcat 服務安裝涉及：

• 註冊系統服務（需 SC_MANAGER_CREATE_SERVICE 權限）
• 寫入註冊表 HKLM\SYSTEM\CurrentControlSet\Services
• 讀取安裝目錄配置文件

無管理員權限時，服務雖能創建，但運行時無法訪問必要資源導致啟動失敗。

解決方案：以管理員身份重新安裝

步驟 1：卸載現有服務

cd /d D:\apache-tomcat-9.0\bin
service.bat remove Tomcat9

步驟 2：以管理員身份打開命令提示符

• Win + X → 選擇「Windows PowerShell (管理員)」或「命令提示符 (管理員)」
• 或：開始菜單搜索 "cmd" → 右鍵 →「以管理員身份運行」

步驟 3：重新安裝服務

cd /d D:\apache-tomcat-9.0\bin
service.bat install Tomcat9

成功提示：The service 'Tomcat9' has been installed.

步驟 4：驗證啟動

net start Tomcat9
# 或
sc start Tomcat9

環境變量配置檢查清單

服務模式下 Tomcat 依賴系統環境變量，請確認：

注意： 服務啟動時讀取的是系統環境變量，而非用戶環境變量，請在「系統變量」區編輯。

配置管理界面訪問權限

開發環境建議配置管理用戶，編輯 conf/tomcat-users.xml：

<tomcat-users xmlns="https://tomcat.apache.org/xml"
              xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="https://tomcat.apache.org/xml tomcat-users.xsd"
              version="1.0">
  <role rolename="manager-gui"/>
  <role rolename="admin-gui"/>
  <user username="admin" password="StrongPass123!" roles="manager-gui,admin-gui"/>
</tomcat-users>

重啟服務後訪問：https://localhost:8080/manager/html

進階排查：服務日誌分析

若仍失敗，檢查以下日誌：

• logs/commons-daemon.YYYY-MM-DD.log — Procrun 服務包裝器日誌
• logs/catalina.YYYY-MM-DD.log — Tomcat 核心日誌
• Windows 事件查看器 → Windows 日誌 → System/Application

常見錯誤代碼對照

生產環境部署建議

1. 專用服務賬戶：創建專用 Windows 用戶運行 Tomcat，最小權限原則
2. JVM 參數調優：在 bin/Tomcat9w.exe 圖形工具中配置堆內存、GC 策略
3. 日誌輪轉：配置 conf/logging.properties 按日期/大小分割
4. 監控集成：啟用 JMX 或集成 Prometheus Exporter

總結

Tomcat 作為 Windows 服務啟動失敗 90% 由權限不足引起。核心解決路徑：卸載服務 → 管理員 CMD → 重新安裝 → 驗證環境變量 → 配置管理用戶。掌握服務日誌分析與 JVM 參數調優，可進一步保障生產環境穩定運行。