Appearance
问题现象
通过域名访问系统首页、后台管理界面(/admin、/store)或调用接口时,浏览器被强制重定向到系统安装页面(如 /install/ 或 /install/index.php)。
根本原因
承信租 V4 系统在核心生命周期与请求初始化阶段,会严格检测系统安装锁文件:
public/install/install.lock- 锁文件存在:系统判定当前站点已完成初始化安装与数据库导入,正常加载各端路由与控制器;
- 锁文件缺失:系统判定当前为全新未部署环境,为了防止未初始化的系统抛出大量缺失数据表的异常,强制将所有 Web 访问拦截并引导至一键安装向导页面。
NOTE
在通过 Git 拉取代码、解压出厂部署包、误删文件或服务器迁移等场景下,如果 public/install/ 目录下未包含 install.lock,就会触发此重定向逻辑。
解决方案与操作步骤
第一步:确认数据库与 .env 已正确配置
在跳过安装向导前,请务必确认站点数据库已导入且 .env 配置有效:
- 检查根目录下
.env中的数据库名称、账号与密码是否正确; - 确认数据库中已经存在完整的系统数据表(如
eb_user、eb_system_config、eb_store_order等)。
第二步:创建安装锁文件
在 Linux 终端中进入项目根目录,执行以下命令快速生成锁文件:
bash
# 进入项目根目录
cd /www/wwwroot/你的项目目录
# 创建安装锁文件
touch public/install/install.lock
# 确保 www 用户具备读取权限
chown -R www:www public/install/install.lock
chmod 644 public/install/install.lock宝塔面板操作方式:
- 打开宝塔面板 ➔【文件】;
- 进入网站根目录下的
public/install/目录; - 点击顶部【新建】➔【新建空文件】;
- 文件名输入
install.lock,保存即可。
第三步:验证并恢复访问
- 在终端执行
php think clear:cache或在 Supervisor 中重启 Swoole 进程; - 强制刷新浏览器缓存(Ctrl + F5 / Cmd + Shift + R),直接访问后台地址(如
https://你的域名/admin),系统即可正常展示后台登录页。
安全警示
CAUTION
严禁在生产运营环境中随意删除 public/install/install.lock。删除该文件将导致外部未授权访问者能够直接打开安装向导,存在数据库被恶意覆写、管理员账号被篡改的重大数据安全风险!