宝塔 Chevereto V4 Something went wrong 错误修复教程

在宝塔面板上安装 Chevereto V4 图床后，访问首页经常会遇到 “Something went wrong” 错误，页面只显示一个事件 ID，没有具体报错信息。

这个问题在宝塔环境下比较常见，主要是因为 PHP 的 putenv() 函数被默认禁用了。下面一步步教你怎么解决。

第一步：开启调试模式查看具体错误

先把 Chevereto 的调试模式打开，才能看到详细的错误信息。

1. 进入 Chevereto 安装目录，找到这个文件：
   app/legacy/load/register-handlers.php
2. 用编辑器打开，找到下面这一行：

$doDebug = in_array($debugLevel, [2, 3], true) || isDebug();

把上面这行注释掉，然后新增一行：

//$doDebug = in_array($debugLevel, [2, 3], true) || isDebug();
$doDebug = true;

保存文件后，刷新 Chevereto 首页，就能看到详细的错误堆栈了。

第二步：查看具体报错内容

开启调试后，通常会看到类似这样的核心错误：

Call to undefined function Chevereto\Vars\putenv()

这个错误的意思是：PHP 找不到 putenv() 这个函数。

第三步：根本原因分析

putenv() 是 PHP 用来设置环境变量的内置函数。宝塔面板为了安全，默认会把一些函数加入禁用列表（disable_functions），putenv 就是其中之一。

Chevereto V4 在运行时需要调用这个函数，所以就报错了。

第四步：解决方法（解除 putenv 禁用）

1. 登录宝塔面板，进入 软件商店。
2. 找到你正在使用的 PHP 版本（比如 PHP 8.1 或 PHP 8.2），点击设置。
3. 切换到 禁用函数 选项卡。
4. 在列表中找到 putenv，把它删除。
5. 点击保存。
6. 切换到 服务 选项卡，点击重启 或重载配置。

重要提醒： 修改禁用函数后一定要重启 PHP，否则配置不会生效。

第五步：验证修复结果

PHP 重启完成后，刷新 Chevereto 首页。如果页面能正常显示，说明问题已经解决。

最后记得把之前开启的调试模式关掉（把 $doDebug = true; 改回去），避免生产环境暴露过多信息。

问题总结

• “Something went wrong” 只是 Chevereto 的通用错误提示。
• 真正的问题通常是 PHP 函数被禁用导致。
• 宝塔环境下遇到类似 Call to undefined function 错误时，优先检查 disable_functions。
• 本次案例的核心解决办法就是把 putenv 从禁用列表中移除并重启 PHP。

希望这个记录能帮到遇到同样问题的朋友。如果还有其他报错，欢迎在评论区把具体错误信息贴出来。