鲁班H5项目常见问题解决方案

鲁班H5项目常见问题解决方案

luban-h5 [WIP]en: web design tool || mobile page builder/editor || mini webflow for mobile page. zh: 类似易企秀的H5制作、建站工具、可视化搭建系统. 项目地址: https://gitcode.com/gh_mirrors/lu/luban-h5

项目基础介绍

鲁班H5（Luban-H5）是一个基于Vue.js开发的可视化搭建系统，旨在通过拖拽快速生成移动端页面。该项目类似于易企秀、Maka、百度H5等平台，提供了一个简单易用的界面，让用户能够快速创建和编辑H5页面。

主要编程语言

• 前端：Vue.js
• 后端：Strapi
• 数据库：SQLite

新手使用注意事项及解决方案

1. 安装依赖时遇到长时间卡顿

问题描述：在执行yarn或npm install命令安装依赖时，可能会遇到长时间卡顿或安装失败的情况。

解决步骤：

1. 检查网络连接：确保网络连接稳定，避免因网络问题导致安装失败。
2. 使用国内镜像：可以尝试使用国内的npm镜像源，例如淘宝镜像。

   npm config set registry https://registry.npm.taobao.org
   

3. 手动安装依赖：如果仍然无法解决，可以尝试手动安装依赖包。

   npm install <package-name> --save
   

2. 启动项目后访问接口403错误

问题描述：启动项目后，访问接口时出现403错误，无法正常获取数据。

解决步骤：

1. 检查API权限配置：确保在http://localhost:1337/admin中正确配置了API权限。
2. 查看日志：检查后端日志，查看是否有详细的错误信息。
3. 重新启动后端服务：有时重启后端服务可以解决权限问题。

   cd back-end/h5-api && yarn dev
   

3. 前端页面无法正常显示

问题描述：前端页面启动后，无法正常显示，或者显示空白页面。

解决步骤：

1. 检查前端构建：确保前端构建成功，没有错误信息。

   cd front-end/h5 && yarn build:engine
   

2. 检查端口占用：确保前端和后端使用的端口没有被其他程序占用。

   lsof -i :1337
   

3. 清除缓存：有时缓存问题会导致页面无法正常显示，可以尝试清除浏览器缓存或重新启动前端服务。

   yarn dev
   

通过以上步骤，新手用户可以更好地解决在使用鲁班H5项目时遇到的一些常见问题。如果问题仍然无法解决，建议查看项目的GitHub Issues页面，寻找类似问题的解决方案或提交新的Issue。

luban-h5 [WIP]en: web design tool || mobile page builder/editor || mini webflow for mobile page. zh: 类似易企秀的H5制作、建站工具、可视化搭建系统. 项目地址: https://gitcode.com/gh_mirrors/lu/luban-h5