mod_dumpio 是 Apache 的调试模块，用于记录 I/O 过滤器链中的原始请求/响应字节，默认不启用因其性能开销大、有安全风险且需手动编译加载。
mod_dumpio 是什么，为什么默认不启用
mod_dumpio 是 Apache 的一个调试模块，它会在数据流经 Apache I/O 过滤器链时，把原始字节（包括请求头、请求体、响应头、响应体）原样记录到错误日志中。它不是为生产环境设计的——开启后每条请求都会产生大量日志，严重拖慢性能，且可能泄露敏感信息（如密码、token、Cookie）。所以 Apache 默认不编译进该模块，也从不启用。
如何启用 mod\_dumpio 并确认加载成功
先确认模块存在并加载：
- Linux 发行版通常需手动启用：
a2enmod dump_io（Debian/Ubuntu），或在httpd.conf中取消注释：LoadModule dumpio_module modules/mod_dumpio.so - 启动前务必检查：
apachectl -M | grep dumpio，输出应含dumpio_module (shared) - 若报错
Cannot load modules/mod_dumpio.so，说明未编译该模块——需重新编译 Apache 时加--enable-dumpio
如何配置 dumpio 日志级别和作用域
mod_dumpio 只响应 LogLevel 中的 dumpio 子级别，且必须设为 debug 或更细粒度（如 dumpio:debug）。它不接受 info 或 warn：
LogLevel debug # 或更精准（推荐）： LogLevel dumpio:debug
作用域决定记录范围：
-
DumpIOInput on：记录所有进来的原始字节（含 POST body、multipart boundary 等） -
DumpIOOutput on：记录所有发出去的原始字节（含响应体、chunked 编码头等） - 二者可单独开，也可都开；建议只在
<virtualhost></virtualhost>或特定<location></location>内启用，避免全局污染 - 注意：若启用了
mod_ssl，DumpIOInput记录的是解密后的明文请求，DumpIOOutput记录的是加密前的明文响应
常见日志内容解读与典型陷阱
日志会出现在 ErrorLog 指定路径（如 /var/log/apache2/error.log），每条记录以 [dumpio:debug] 开头，例如：
[Wed Jun 05 10:23:41.123456 2024] [dumpio:debug] [pid 12345] mod_dumpio.c(123): [client 192.168.1.100:54321] dumpio_in: 127 bytes
[Wed Jun 05 10:23:41.123457 2024] [dumpio:debug] [pid 12345] mod_dumpio.c(123): [client 192.168.1.100:54321] dumpio_in: POST /api/login HTTP/1.1\r\nHost: example.com\r\nContent-Length: 42\r\n\r\n{"user":"admin","pass":"123456"}
容易踩的坑：
- 日志不滚动：
mod_dumpio不受rotatelogs或systemd-journald日志轮转控制，必须靠外部脚本或 logrotate 配合apache2ctl graceful - 二进制内容被截断：默认只显示 ASCII 可见字符，非 ASCII 字节（如 UTF-8 多字节、图片上传）会显示为
.，无法还原原始 payload - gzip 响应体已解压：如果后端返回了
Content-Encoding: gzip，DumpIOOutput记录的是 Apache 解压后的明文，不是 wire 上的压缩流 - 并发高时日志错乱：多线程写同一文件，不同请求的 dump 行可能交错，需用
pid和时间戳人工对齐
真要抓完整原始流量，mod_dumpio 只适合低频调试；高频或需要保真，直接上 tcpdump + Wireshark 更可靠。
