如何修复Laravel中的Bad file descriptor错误？

问题详情 #

访问Laravel应用时出现错误：

fwrite(): Write of 4278 bytes failed with errno=9 Bad file descriptor

错误发生在public/index.php执行以下代码时：

$response = $kernel->handle(
    $request = Request::capture()
)->send()

环境参数：

• PHP版本：8.3.12
• Laravel版本：11.26.0

已尝试的操作 #

• 修复目录权限：chmod -R 775 storage bootstrap/cache
• 清除缓存：php artisan config:clear/view:clear/cache:clear
• 创建存储软链接：php artisan storage:link
• 更新Composer依赖：composer update

进一步排查与解决建议 #

1. 检查进程文件描述符限制 #

errno=9表示文件描述符无效或已关闭，大概率是进程可用的文件描述符耗尽：

• 查看运行PHP的用户的文件描述符上限：执行ulimit -n，确保数值不低于1024。若不足，可修改/etc/security/limits.conf添加如下配置（需重启服务器生效）：

  www-data soft nofile 4096
  www-data hard nofile 8192
  

• 检查PHP-FPM配置（如php-fpm.conf）中的rlimit_files参数，调整至合理值后重启PHP-FPM。

2. 排查响应输出环节的异常 #

send()方法负责向客户端输出响应，可能是输出缓冲区被意外终止：

• 检查项目代码（中间件、控制器、服务提供者等）中是否存在提前调用exit()、die()、ob_end_clean()等会关闭输出缓冲区的函数。
• 临时关闭调试模式（将.env中APP_DEBUG设为false），验证是否为调试信息输出时触发的问题。

3. 排查PHP扩展与配置冲突 #

• 禁用近期新增的PHP扩展（如Xdebug、OPcache等），逐一测试是否是扩展导致的文件描述符异常。
• 检查PHP配置文件中的output_buffering、max_execution_time参数，确保配置正常。

4. 验证服务器基础环境 #

• 检查服务器磁盘空间：执行df -h，确认磁盘未被占满。
• 重启Web服务器（Nginx/Apache）和PHP-FPM进程，释放可能占用的无效文件描述符。

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