AWS EC2上httpd.service启动失败：配置正常却报AH00016错误

问题背景 #

AWS EC2实例上的Apache用于部署Flask应用，此前运行正常。尝试添加SSL未成功后改回普通HTTP，现在httpd.service启动失败。执行sudo httpd -t显示Syntax OK，但错误日志提示AH00016: Configuration Failed。

相关系统日志 #

● httpd.service - The Apache HTTP Server
   Loaded: loaded (/usr/lib/systemd/system/httpd.service; enabled; vendor preset: disabled)
   Active: failed (Result: exit-code) since Tue 2023-06-13 01:10:05 UTC; 15s ago
     Docs: man:httpd.service(8)
  Process: 2298 ExecStart=/usr/sbin/httpd $OPTIONS -DFOREGROUND (code=exited, status=1/FAILURE)
 Main PID: 2298 (code=exited, status=1/FAILURE)
   Status: "Reading configuration..."

Jun 13 01:10:05 ip-172-31-40-174.us-east-2.compute.internal systemd[1]: Starting The Apache HTTP Server...
Jun 13 01:10:05 ip-172-31-40-174.us-east-2.compute.internal systemd[1]: httpd.service: main process exited, code=exit...RE
Jun 13 01:10:05 ip-172-31-40-174.us-east-2.compute.internal systemd[1]: Failed to start The Apache HTTP Server.
Jun 13 01:10:05 ip-172-31-40-174.us-east-2.compute.internal systemd[1]: Unit httpd.service entered failed state.
Jun 13 01:10:05 ip-172-31-40-174.us-east-2.compute.internal systemd[1]: httpd.service failed.

当前httpd.conf虚拟主机配置 #

<VirtualHost *:80>
     WSGIDaemonProcess ocr_api python-path=/var/www/html/ocr_api:/var/www/html/ocr/lib/python3.7/site-packages
     ServerName ******
     WSGIScriptAlias /ocr_api /var/www/html/ocr_api/api.wsgi
      
     <Directory /var/www/html/ocr_api/>
         Options +Indexes +FollowSymLinks
         AllowOverride All
         Require all granted
     </Directory>
     ErrorLog custom_logs/ocr_error.log

</VirtualHost>

排查步骤 #

• 检查日志路径的存在性与权限：配置中的ErrorLog custom_logs/ocr_error.log是相对路径，默认基于Apache的ServerRoot（通常为/etc/httpd）。执行以下命令确认：

  # 检查目录是否存在
  ls -ld /etc/httpd/custom_logs
  # 若不存在则创建并设置权限
  sudo mkdir -p /etc/httpd/custom_logs && sudo chown apache:apache /etc/httpd/custom_logs
  # 创建日志文件并设置权限
  sudo touch /etc/httpd/custom_logs/ocr_error.log && sudo chown apache:apache /etc/httpd/custom_logs/ocr_error.log
  

  Apache启动时若无法写入日志文件，会触发配置失败。

• 验证WSGI模块加载状态：确认mod_wsgi模块已正确加载，避免因SSL配置修改时误删模块加载指令：

  httpd -M | grep wsgi
  

  若无输出，检查/etc/httpd/conf.modules.d/10-wsgi.conf文件是否包含LoadModule wsgi_module modules/mod_wsgi.so，若为虚拟环境编译的mod_wsgi，需确保路径与Python版本匹配。

• 检查Python路径有效性：WSGIDaemonProcess中的python-path指向的目录需真实存在，且与mod_wsgi编译的Python版本兼容：

  # 检查路径是否存在
  ls -l /var/www/html/ocr/lib/python3.7/site-packages
  # 查看mod_wsgi编译的Python版本
  mod_wsgi --version
  

  若Python版本不匹配，会导致WSGI进程无法启动，进而引发Apache配置失败。

• 清理遗留的SSL配置：尝试添加SSL后可能残留未注释的SSL指令，比如Listen 443、SSLCertificateFile等，这些指令会因缺少证书文件导致启动失败：

  grep -r "SSLCertificate\|Listen 443" /etc/httpd/conf /etc/httpd/conf.d
  

  找到相关指令后，要么注释掉，要么补全正确的证书路径（若仍需SSL），当前改回HTTP建议直接注释所有SSL相关配置块。

• 前台启动Apache获取详细错误：使用前台启动方式，终端会输出更详细的启动错误信息，比系统日志更直观：

  sudo /usr/sbin/httpd -DFOREGROUND
  

  启动失败时的实时输出会直接指出问题根源，比如文件缺失、权限不足等。

• 验证应用目录权限：确保Apache进程（apache用户）拥有Flask应用目录的读取权限：

  sudo chown -R apache:apache /var/www/html/ocr_api
  sudo chmod -R 755 /var/www/html/ocr_api
  

内容的提问来源于stack exchange，提问作者Amon