pgBadger HTML报告需通过HTTP服务访问，禁用直接双击打开；须显式指定时间范围、使用绝对路径与正确用户权限运行；慢查询需调大--max-query-size防截断。
pgBadger 生成的 HTML 报告打不开或图表不显示
常见现象是双击 report.html 直接用浏览器打开，结果空白、报错 Access to script at 'file:///...' from origin 'null' has been blocked，或者图表区域一片灰。这是因为现代浏览器默认禁用本地文件的跨域脚本加载（比如 Chart.js 依赖的 JS 文件），而 pgBadger 输出的 HTML 是纯静态资源，没走 HTTP 服务。
解决方法只有一条路：起一个最小 HTTP 服务来访问报告：
- Linux/macOS：在报告目录下运行
python3 -m http.server 8000，然后浏览器打开http://localhost:8000/report.html - Windows（有 Python）：同上；没有 Python 的话，用
npm install -g http-server后执行http-server -p 8000 - 别用
open report.html或直接拖进浏览器窗口——这是最常踩的坑
每日自动生成报告时，日志路径和时间范围总对不上
pgBadger 默认不自动识别“昨天的日志”，它只按文件名或内容里的时间戳解析。PostgreSQL 日志滚动后，文件名可能带日期（如 postgresql-2024-06-15.log），也可能不带（如 postgresql.log.1）。如果没指定 --from/--to，它会分析整个文件，导致报告混入无关时段数据。
实操建议：
- 确保 PostgreSQL 开启了
log_line_prefix = '%t '（ISO 格式时间戳），这是 pgBadger 准确切分时间的基础 - 每日脚本里显式限定范围：用
date -d 'yesterday' +'%Y-%m-%d %H:%M:%S'算出起止时间，传给--from和--to - 如果日志是压缩的（
.log.gz），pgBadger 能自动解压，但路径必须写全，比如/var/log/postgresql/postgresql-$(date -d 'yesterday' +'%Y-%m-%d').log.gz
用 cron 运行 pgBadger 脚本失败，提示找不到命令或权限拒绝
cron 环境变量极简，PATH 通常只有 /usr/bin:/bin，而 pgBadger 安装路径可能是 /usr/local/bin/pgbadger 或用户自己编译的路径。另外，日志文件权限往往只对 postgres 用户可读。
关键动作：
- 在 cron 中写绝对路径：用
which pgbadger查到真实路径，比如/usr/local/bin/pgbadger - 用
sudo -u postgres切换用户运行，而不是改日志文件权限（不安全） - 重定向输出到日志：加
> /var/log/pgbadger/cron.log 2>&1，方便查错 - 测试前先手动以相同用户+相同环境变量运行一遍：
sudo -u postgres env -i PATH=/usr/local/bin:/usr/bin:/bin /usr/local/bin/pgbadger ...
报告里慢查询 SQL 被截断，看不全具体条件
pgBadger 默认只提取日志中每行前 1024 字符，而带长参数的 INSERT/UPDATE 或嵌套 CTE 的查询很容易超长。结果就是报告里只显示 INSERT INTO orders (...) VALUES ($1, $2, ...，后面关键 WHERE 条件没了。
必须调整两个参数：
-
--max-query-size 4096：增大单条 SQL 提取长度，建议设为 4096 或更高（需匹配日志实际行长） -
--exclude-failed：如果日志里大量报错语句干扰分析，加上这个跳过失败查询，聚焦真正执行慢的 - 注意：增大
--max-query-size会略微增加内存占用和解析时间，但对每日报告影响微乎其微
