在 Red Hat Enterprise Linux 5 (RHEL5) 虛擬機環境中，執行 service httpd start 失敗，service httpd status 顯示服務異常。經排查發現主配置檔 /etc/httpd/conf/httpd.conf 損壞或配置錯誤。本文提供兩種修復方案：備份檔案快速恢復、手動逐項修正關鍵指令，並附上標準 LoadModule 完整列表供參考對照。

問題現象

[root@localhost ~]# service httpd start
Starting httpd:                                           [FAILED]
[root@localhost ~]# service httpd status
httpd is stopped

錯誤日誌 /var/log/httpd/error_log 通常提示：Syntax error on line XXX of /etc/httpd/conf/httpd.conf。

方案一：備份檔案快速恢復 (最快、最穩)

RHEL 安裝 httpd 時會自動產生備份 /etc/httpd/conf/httpd.conf.bak (或 httpd.conf.rpmnew)，內容為原始預設配置。

cp /etc/httpd/conf/httpd.conf.bak /etc/httpd/conf/httpd.conf
service httpd start
service httpd status

若無 .bak，可從 RPM 包提取：

rpm2cpio httpd-*.rpm | cpio -idmv
# 產生 ./etc/httpd/conf/httpd.conf
cp ./etc/httpd/conf/httpd.conf /etc/httpd/conf/

方案二：手動修正關鍵配置錯誤 (適合需保留自訂設定)

編輯 vi /etc/httpd/conf/httpd.conf，依序檢查修正：

1. ServerName 指令缺失或語法錯誤

# 錯誤：ServerName 未設定或格式錯
# 修正：註解掉或設定正確 FQDN
# ServerName www.example.com:80
ServerName localhost:80

2. ServerAdmin 電子郵件格式不完整

# 錯誤：ServerAdmin root
# 修正：完整電子郵件格式
ServerAdmin admin@example.com

3. LockFile 路徑錯誤或權限問題

# 錯誤：LockFile /var/lock/httpd.lock (目錄不存在或權限)
# 修正：註解掉使用預設，或指定正確路徑
# LockFile /var/lock/subsys/httpd

4. LoadModule 指令路徑錯誤、遺漏、順序錯誤

此為最常見導致啟動失敗的原因。模組檔案必須存在於 /usr/lib/httpd/modules/ (32-bit) 或 /usr/lib64/httpd/modules/ (64-bit)。建議直接以備份檔中的 LoadModule 區塊完整替換。

標準 LoadModule 完整參考列表 (RHEL 5 / httpd 2.2 系列)

LoadModule auth_basic_module modules/mod_auth_basic.so
LoadModule auth_digest_module modules/mod_auth_digest.so
LoadModule authn_file_module modules/mod_authn_file.so
LoadModule authn_alias_module modules/mod_authn_alias.so
LoadModule authn_anon_module modules/mod_authn_anon.so
LoadModule authn_dbm_module modules/mod_authn_dbm.so
LoadModule authn_default_module modules/mod_authn_default.so
LoadModule authz_host_module modules/mod_authz_host.so
LoadModule authz_user_module modules/mod_authz_user.so
LoadModule authz_owner_module modules/mod_authz_owner.so
LoadModule authz_groupfile_module modules/mod_authz_groupfile.so
LoadModule authz_dbm_module modules/mod_authz_dbm.so
LoadModule authz_default_module modules/mod_authz_default.so
LoadModule ldap_module modules/mod_ldap.so
LoadModule authnz_ldap_module modules/mod_authnz_ldap.so
LoadModule include_module modules/mod_include.so
LoadModule log_config_module modules/mod_log_config.so
LoadModule logio_module modules/mod_logio.so
LoadModule env_module modules/mod_env.so
LoadModule ext_filter_module modules/mod_ext_filter.so
LoadModule mime_magic_module modules/mod_mime_magic.so
LoadModule expires_module modules/mod_expires.so
LoadModule deflate_module modules/mod_deflate.so
LoadModule headers_module modules/mod_headers.so
LoadModule usertrack_module modules/mod_usertrack.so
LoadModule setenvif_module modules/mod_setenvif.so
LoadModule mime_module modules/mod_mime.so
LoadModule dav_module modules/mod_dav.so
LoadModule status_module modules/mod_status.so
LoadModule autoindex_module modules/mod_autoindex.so
LoadModule info_module modules/mod_info.so
LoadModule dav_fs_module modules/mod_dav_fs.so
LoadModule vhost_alias_module modules/mod_vhost_alias.so
LoadModule negotiation_module modules/mod_negotiation.so
LoadModule dir_module modules/mod_dir.so
LoadModule actions_module modules/mod_actions.so
LoadModule speling_module modules/mod_speling.so
LoadModule userdir_module modules/mod_userdir.so
LoadModule alias_module modules/mod_alias.so
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule cache_module modules/mod_cache.so
LoadModule suexec_module modules/mod_suexec.so
LoadModule disk_cache_module modules/mod_disk_cache.so
LoadModule file_cache_module modules/mod_file_cache.so
LoadModule mem_cache_module modules/mod_mem_cache.so
LoadModule cgi_module modules/mod_cgi.so

5. 其他常見檢查點

• DocumentRoot 目錄是否存在、權限正確 (755)。
• Directory 區塊 AllowOverride, Order allow,deny, Allow from all (2.2 語法) 或 Require all granted (2.4 語法)。
• ErrorLog, CustomLog 路徑目錄可寫。
• SELinux 環境：setsebool -P httpd_can_network_connect 1、restorecon -R /var/www。

修復後驗證流程

# 1. 語法檢查 (不啟動服務)
httpd -t
# 或
service httpd configtest

# 2. 啟動服務
service httpd start
# 或 systemctl start httpd

# 3. 確認狀態
service httpd status
netstat -antlp | grep :80

# 4. 瀏覽器/命令列測試
curl -I https://localhost/
wget -qO- https://localhost/ | head -20

預防與最佳實踐

1. 配置變更前必備份：cp /etc/httpd/conf/httpd.conf{,.bak.$(date +%F)}。
2. 使用版本控管：/etc/httpd/conf/ 納入 Git/etckeeper。
3. 模組化配置：將虛擬主機、SSL、代理等配置拆分至 /etc/httpd/conf.d/*.conf，主檔保持精簡。
4. 語法檢查自動化：在腳本/Ansible 中部署前強制執行 httpd -t。
5. 監控告警：監控 httpd 進程存活、埠口 80/443 監聽、錯誤日誌關鍵字。

總結

httpd 啟動失敗 90% 以上源於 httpd.conf 語法或模組路徑錯誤。方案一 (備份還原) 最快止血，適合緊急恢復服務；方案二 (手動修正) 適合需保留自訂虛擬主機、SSL、重寫規則等複雜配置。核心原則：模組路徑必須與檔案系統實際一致、指令語法嚴格遵循 Apache 版本規範、SELinux 布林值正確。掌握 httpd -t 語法檢查與 rpm2cpio 提取原始配置，是系統管理員必備技能。