Laravel8部署后报HTTP ERROR 500及JsonSerializable接口不存在如何解决

问题原因 #

该错误由服务器PHP环境缺少json扩展导致：JsonSerializable是PHP原生JSON扩展提供的内置接口，Laravel 8的集合组件依赖该接口实现数据序列化逻辑，扩展缺失会触发PHP致命错误，最终返回HTTP 500响应。

解决步骤 #

• 先确认服务器PHP版本符合Laravel 8运行要求：Laravel 8要求PHP版本 >= 7.3，需保证站点绑定的PHP版本满足最低要求
• 安装对应PHP版本的JSON扩展：
  • 若为Debian/Ubuntu系统，将以下命令中的7.4替换为站点实际使用的PHP版本号后执行：

    sudo apt install php7.4-json
    

  • 若为CentOS/RHEL系统，执行：

    sudo yum install php-json
    

  • 若使用宝塔、cPanel等服务器管理面板，直接进入对应PHP版本的扩展管理页面，找到json扩展点击安装即可
• 扩展安装完成后重启对应PHP服务：
  • Nginx + php-fpm环境，重启对应版本的php-fpm，以PHP7.4为例：

    sudo systemctl restart php7.4-fpm
    

  • Apache环境，重启Apache服务：

    sudo systemctl restart apache2
    

• 若重启后错误仍存在，检查对应PHP版本的php.ini配置文件，确认extension=json.so（Linux）或extension=json.dll（Windows）配置项没有被注释（行首无;），修改后再次重启服务
• 验证修复效果：刷新项目页面确认500错误消失，可临时在站点public目录新建info.php文件写入<?php phpinfo();，访问后搜索json确认扩展已启用，验证完成后及时删除该测试文件避免安全风险

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