如何开启mod_auth_openidc调试模式及查看对应日志文件？

一、开启mod_auth_openidc调试模式 #

mod_auth_openidc有独立的日志级别配置，仅开启Apache全局调试不会生效，需在Apache配置文件（httpd.conf或对应虚拟主机配置文件）中添加以下指令：

OIDCLogLevel debug

注意该指令需放在LoadModule auth_openidc_module modules/mod_auth_openidc.so（路径根据实际安装情况调整）之后的配置段内。

二、指定日志文件位置 #

1. 默认输出：mod_auth_openidc的调试日志默认会写入Apache的错误日志，常见路径：
   • Debian/Ubuntu: /var/log/apache2/error.log
   • RHEL/CentOS: /var/log/httpd/error_log
2. 单独指定日志文件：若需要将mod_auth_openidc日志单独存放，可在对应虚拟主机配置块中添加ErrorLog指令，示例：

   <VirtualHost *:443>
       # 其他SSL配置...
       ErrorLog "/var/log/apache2/oidc_debug.log"
       OIDCLogLevel debug
   </VirtualHost>
   

   确保Apache运行用户（通常为www-data或apache）拥有该日志文件所在目录的写入权限。

三、排查调试日志不生效的问题 #

• 验证Apache配置语法：执行apachectl configtest（或httpd -t），排查配置语法错误，修正后重启服务。
• 重启Apache服务：修改配置后必须重启服务才能生效，执行systemctl restart apache2（Debian/Ubuntu）或service httpd restart（RHEL/CentOS）。
• 检查指令位置：确保OIDCLogLevel debug指令未被后续配置覆盖，且位于LoadModule指令之后。

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