Linux H5环境搭建：数据库配置与项目快速启动指南

AI生成结论图，仅供参考

　　若项目使用SQLite（推荐初学者或小型H5应用），无需额外安装数据库服务。确认系统已预装sqlite3：执行sqlite3 --version，输出版本号即表示可用。项目中只需在代码里指定.db文件路径（如./data/app.db），首次访问时自动创建。注意确保项目目录对当前用户有读写权限：chmod -R u+rw ./data，防止运行时报“unable to open database file”错误。

　　若需MySQL支持（如含用户登录、订单等结构化业务），执行sudo apt update && sudo apt install mysql-server。安装后运行sudo mysql_secure_installation设置root密码并禁用不安全选项。接着创建专用数据库与用户：sudo mysql -u root -p进入后执行：CREATE DATABASE h5_app DEFAULT CHARSET utf8mb4;，再执行CREATE USER 'h5user'@'localhost' IDENTIFIED BY 'StrongPass123!'; GRANT ALL ON h5_app. TO 'h5user'@'localhost'; FLUSH PRIVILEGES;。将这些连接参数填入项目配置文件（如.env中的DB_HOST=localhost、DB_NAME=h5_app等）。

　　项目启动前，确保已安装Node.js（建议v18.x LTS）：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs。进入项目根目录，运行npm ci（比npm install更快且锁定依赖版本）。若项目含构建脚本（如Vite或Webpack），执行npm run build生成静态资源；若为纯前端+API代理模式，直接运行npm start即可启动开发服务器，默认监听http://localhost:3000。

　　关键检查点：打开浏览器访问http://localhost:3000，确认页面加载无空白；打开浏览器开发者工具的Console与Network标签页，观察是否有404接口请求或数据库连接拒绝错误。若后端API报错，检查node_modules/.bin/nodemon或PM2日志（pm2 logs）；常见问题包括MySQL未启动（sudo systemctl status mysql）、端口被占用（lsof -i :3000）或.env文件未正确加载（确认其位于项目根目录且无BOM头）。

　　完成上述步骤后，H5项目已在Linux本地稳定运行。后续迭代可结合Git管理代码、Nginx反向代理部署生产环境，或使用Docker封装整个栈（含MySQL容器与Node服务）。所有操作均基于命令行完成，无需图形界面，适合云服务器或WSL场景。环境一旦配置成功，新项目仅需复制配置模板与package.json脚本，即可复用同一套启动逻辑。

（编辑：92站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!