Skip to content

问题现象 ​

通过域名访问系统首页、后台管理界面(/admin、/store)或调用接口时,浏览器被强制重定向到系统安装页面(如 /install/ 或 /install/index.php)。


根本原因 ​

承信租 V4 系统在核心生命周期与请求初始化阶段,会严格检测系统安装锁文件:

public/install/install.lock
  • 锁文件存在:系统判定当前站点已完成初始化安装与数据库导入,正常加载各端路由与控制器;
  • 锁文件缺失:系统判定当前为全新未部署环境,为了防止未初始化的系统抛出大量缺失数据表的异常,强制将所有 Web 访问拦截并引导至一键安装向导页面。

NOTE

在通过 Git 拉取代码、解压出厂部署包、误删文件或服务器迁移等场景下,如果 public/install/ 目录下未包含 install.lock,就会触发此重定向逻辑。


解决方案与操作步骤 ​

第一步:确认数据库与 .env 已正确配置 ​

在跳过安装向导前,请务必确认站点数据库已导入且 .env 配置有效:

  1. 检查根目录下 .env 中的数据库名称、账号与密码是否正确;
  2. 确认数据库中已经存在完整的系统数据表(如 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

宝塔面板操作方式:

  1. 打开宝塔面板 ➔【文件】;
  2. 进入网站根目录下的 public/install/ 目录;
  3. 点击顶部【新建】➔【新建空文件】;
  4. 文件名输入 install.lock,保存即可。

第三步:验证并恢复访问 ​

  1. 在终端执行 php think clear:cache 或在 Supervisor 中重启 Swoole 进程;
  2. 强制刷新浏览器缓存(Ctrl + F5 / Cmd + Shift + R),直接访问后台地址(如 https://你的域名/admin),系统即可正常展示后台登录页。

安全警示 ​

CAUTION

严禁在生产运营环境中随意删除 public/install/install.lock。删除该文件将导致外部未授权访问者能够直接打开安装向导,存在数据库被恶意覆写、管理员账号被篡改的重大数据安全风险!

安徽用易软件科技有限公司 · 承信租 V4 官方技术文档中心