在宝塔面板上部署 Chevereto V4 图床程序，安装过程顺利，但访问首页时遇到了 “Something went wrong” 错误。页面仅显示事件 ID，无具体错误信息。
排查过程：
1. 启用调试模式定位问题
进入 Chevereto 安装目录 app/legacy/load/register-handlers.php，编辑 register-handlers.php 文件
找到行：$doDebug = in_array($debugLevel, [2, 3], true) || isDebug();,
改为：//$doDebug = in_array($debugLevel, [2, 3], true) || isDebug();
$doDebug = true;
//相当于新增加一行$doDebug = true;控制错误日志是否开启
保存文件后刷新问题页面
2. 识别关键错误
开启调试模式后，页面显示详细错误堆栈
核心错误信息：[Call to undefined function Chevereto\Vars\putenv()]
此错误表明 putenv() 函数未被定义或不可用
3. 确认问题根源
putenv() 是 PHP 内置的环境变量操作函数
宝塔面板默认将 putenv() 列入禁用函数列表（disable_functions）
此安全限制导致 Chevereto V4 运行时报错
4. 解决方案：解除函数禁用
[1] 登录宝塔面板
[2] 导航到 软件商店 → 找到使用的 PHP 版本 (如 PHP-8.1) → 点击 设置
[3] 切换到 禁用函数 选项卡
[4] 在列表中查找 putenv 并删除
[重要] 点击保存后 → 切换到服务选项卡 → 重启或重载配置
5. 验证结果
> PHP 重启完成后 → 刷新 Chevereto 首页
> 结果：成功显示正常界面 → 问题解决
问题总结：
Something went wrong 报错 → 首先启用调试模式查看具体错误
Call to undefined function… 错误 → 通常是被禁用函数导致
宝塔环境 → 首要检查 disable_functions 列表
本次案例 → putenv 被默认禁用
关键步骤 → 修改后务必重启PHP服务
希望这个记录能帮助遇到同样问题的朋友快速定位并解决。
