磁盘满导致frankenphp日志无法写入,本质是存储空间或inode耗尽;需交叉验证df -h/df -i/lsof,定位大日志并truncate清空,配置logrotate、限制日志级别、分离路径及添加水位监控防复发。

FrankenPHP 服务器磁盘满导致日志无法写入,本质不是 FrankenPHP 自身故障,而是底层存储已无可用空间或 inode 耗尽,所有依赖文件写入的操作(包括日志、session、临时文件、PHP 错误输出)都会失败。处理核心是:**快速释放空间 + 保留日志句柄 + 防止复发**。
先确认是不是真满了
别直接删文件,先交叉验证:
-
df -h:看
/、/var、/tmp或 FrankenPHP 日志所在挂载点(如/var/log/frankenphp)是否 Use% 达 100%,Avail 是否为 0; -
df -i:若 IUse% = 100%,哪怕 df -h 还剩空间,也会报
No space left on device——常见于大量小日志轮转未清理; -
lsof | grep deleted:检查是否有已被
rm但 FrankenPHP 进程仍在写入的旧日志(比如access.log (deleted)),这类文件 du 看不到,df 却算占用。
定位日志增长源头
FrankenPHP 默认使用系统日志路径(如 /var/log/frankenphp/)或继承 PHP-FPM 的日志配置(如 error_log = /var/log/php-fpm.log)。重点排查:
- 运行
sudo du -sh /var/log/frankenphp/* /var/log/php-fpm.log* 2>/dev/null | sort -hr,看哪个日志最大; - 检查是否启用了调试级日志(如
log_level = debug),会极速膨胀; - 查看
journalctl -u frankenphp --disk-usage,确认 systemd journal 是否占满/var/log/journal/; - 用
find /var/log -name "*.log" -size +100M -ls 2>/dev/null | sort -k7 -nr快速揪出超大日志文件。
安全释放空间(不中断服务)
FrankenPHP 基于 SAPI 运行,日志文件句柄由主进程持有。删除文件会断开写入,清空内容更稳妥:
- 清空当前活跃日志:
sudo truncate -s 0 /var/log/frankenphp/access.log和sudo truncate -s 0 /var/log/frankenphp/error.log; - 若日志已轮转但未压缩归档,删掉旧压缩包:
sudo rm -f /var/log/frankenphp/*.log.*.gz; - 清理 systemd 日志(若占大头):
sudo journalctl --vacuum-size=200M或sudo journalctl --vacuum-time=7d; - 若
lsof | grep deleted显示 FrankenPHP 进程占着已删日志,需 reload:sudo systemctl reload frankenphp(触发日志 reopen)或sudo pkill -USR1 -f frankenphp(等效于 Nginx 的 USR1)。
防复发:从配置和机制入手
人工清理只是救火,必须固化防护:
- 启用 logrotate:确保
/etc/logrotate.d/frankenphp存在,内容含daily rotate 14 compress missingok notifempty; - 限制日志级别:在 FrankenPHP 配置中关闭 debug(如
log_level = warning),生产环境避免error_log = /dev/stderr直接打屏; - 分离日志路径:将日志目录挂到独立分区或 tmpfs(如
tmpfs /var/log/frankenphp tmpfs defaults,size=512M,mode=0755 0 0); - 加磁盘水位监控:用
df -h | awk '$5 > 90 {print "ALERT: "$1" is "$5"% full"}'写进 crontab,每5分钟检查并告警。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











