LECMS安装后怎么打不开

按着这篇的顺序走一遍，你基本能在 10 分钟内定位到 LECMS 装完打不开的真正原因，而不是反复重装。

第一步：先确定“打不开”是哪一种

先看现象，不同的现象对应完全不同的故障点，别一上来就重装。

• 白屏、没有任何输出：PHP 报错被关掉了，去开错误显示（见第二步）。
• HTTP 500：PHP 版本不对或程序报致命错误。
• HTTP 404，首页能开、内页打不开：伪静态没配（见第四步）。
• HTTP 502 / 504：PHP 进程挂了或超时，看 PHP 是否启动。
• 一直转圈最后超时：数据库连不上，或服务器防火墙没放行。
• 跳回安装页 / 提示“请先安装”：install 目录没删或配置没写入。

按 F12 打开开发者工具，切到 Network（网络） 标签，刷新页面，看第一条请求的状态码，这就是你的排查起点。

第二步：把错误日志打开，别靠猜

LECMS 白屏时日志是唯一线索，这一步做完你能直接看到报错内容。

如果是宝塔面板（7.7 或 8.x 版本），路径是：网站 → 找到你的站点 → 点「设置」→ 左侧「网站日志」，错误日志在 /www/wwwlogs/你的域名.error.log。命令行实时看：

tail -f /www/wwwlogs/你的域名.error.log

同时临时打开 PHP 错误显示：宝塔面板 软件商店 → 已安装 → 找到对应 PHP → 设置 → 配置修改，把 display_errors 改成 On，保存后重启 PHP。看完记得改回 Off。

注意：生产环境长期开着 display_errors 会把服务器绝对路径暴露给访客，排查完立刻关掉。

第三步：核对 PHP 版本和扩展

LECMS 对 PHP 版本很挑，用错版本是最常见的“装完就白屏”。在宝塔面板 网站 → 站点 → 设置 → 网站目录 上方可以看到当前绑定的 PHP 版本。

• 建议用 PHP 7.0～7.4；PHP 8.x 多数 LECMS 版本会直接报致命错误。
• 必需扩展：pdo_mysql、mbstring、curl、gd、fileinfo、openssl、zip。

安装扩展的位置：软件商店 → 已安装 → PHP-7.4 → 设置 → 安装扩展，缺哪个点哪个的「安装」。

再看 禁用函数 页签，如果列表里有 putenv、exec、symlink、proc_open，删除它们（LECMS 的缓存和图片处理会用到）。

注意：改完 PHP 配置必须点「重启」，只保存不重启不生效。

第四步：配伪静态和入口文件

内页 404、只有首页能开，就是这一步没做。

• Nginx：站点设置 → 伪静态 → 下拉选择对应的 LECMS / ThinkPHP 规则，保存。没有现成规则就手写一条 rewrite ^/(.*)$ /index.php?s=$1 last;。
• Apache：确认站点根目录存在 .htaccess，并在站点配置里把 AllowOverride None 改成 AllowOverride All，然后重启 Apache。

如果访问域名跳到目录列表或直接下载 index.php，说明站点运行目录设错了——应该在 站点设置 → 网站目录 → 运行目录 选择程序实际入口所在目录（通常是 /public 或根目录）。

第五步：修目录权限、清 runtime 缓存

权限不对会让程序读不到配置或写不了缓存，表现为白屏或 500。

chown -R www:www /www/wwwroot/你的站点目录
find /www/wwwroot/你的站点目录 -type d -exec chmod 755 {} \;
find /www/wwwroot/你的站点目录 -type f -exec chmod 644 {} \;
chmod -R 777 /www/wwwroot/你的站点目录/runtime

然后删掉 runtime 目录下的缓存文件（保留目录本身），刷新页面重试。

第六步：确认数据库和 install 目录

数据库账号密码错，页面会卡住或报连接失败。

1. 打开 config/database.php（部分版本在 application/database.php），核对 hostname、database、username、password、hostport，注意数据库名和用户名不要写反。
2. 宝塔 数据库 页面确认该库已创建、用户已授权。
3. 装完后把 install 目录改名或删除，否则可能反复跳安装页，也存在被重装的风险。

第七步：端口、防火墙、域名解析

本地能开、外网打不开，就是这一层。检查宝塔 安全 页面和云服务器控制台安全组是否放行了 80、443；域名是否已解析到服务器 IP（ping 你的域名 验证）；站点设置里 域名管理 是否绑定了正确域名。开了 SSL 却访问 http，也会出现打不开或跳转异常。

第八步：还不行就开调试模式

在入口文件或配置文件中把 app_debug 设为 true，刷新页面会直接显示完整报错堆栈，照报错去搜基本能定位。排查完改回 false。

小结

• 先看 HTTP 状态码分类，再动手，不要盲目重装。
• 白屏就开错误日志和 display_errors。
• PHP 版本优先选 7.x，并补全 pdo_mysql、mbstring 等扩展。
• 内页 404 一定是伪静态或运行目录的问题。
• 权限用 755/644，runtime 给 777 并清缓存。
• 核对数据库配置，装完删除 install 目录。
• 外网打不开查防火墙、安全组和域名解析。