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

　　H5项目在Linux环境下运行，通常依赖轻量级数据库（如SQLite或MySQL）与Node.js服务。本文以Ubuntu 22.04为例，聚焦数据库配置与项目一键启动流程，避免冗余工具链，确保开发者30分钟内完成本地环境就绪。

　　若项目使用SQLite（推荐初学者或单机开发），无需额外安装服务。确认系统已预装sqlite3：执行sqlite3 --version，若提示命令未找到，运行sudo apt update && sudo apt install sqlite3即可。项目中的db.sqlite文件由应用自动创建，只需确保项目目录具备读写权限（如chmod 755 ./data）。

AI辅助设计图，仅供参考

　　若选用MySQL（适用于多环境协同或需事务支持场景），先安装服务：sudo apt install mysql-server。安装完成后，运行sudo mysql_secure_installation设置root密码并禁用匿名登录。接着创建专用数据库与用户：进入MySQL控制台（sudo mysql -u root -p），执行CREATE DATABASE h5_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;，再创建用户CREATE USER 'h5user'@'localhost' IDENTIFIED BY 'your_secure_password';，最后授权GRANT ALL PRIVILEGES ON h5_dev. TO 'h5user'@'localhost'; FLUSH PRIVILEGES;。

　　项目启动前，检查.env文件是否正确配置数据库连接参数。SQLite示例：DB_TYPE=sqlite、DB_PATH=./data/db.sqlite；MySQL示例：DB_TYPE=mysql、DB_HOST=localhost、DB_PORT=3306、DB_NAME=h5_dev、DB_USER=h5user、DB_PASS=your_secure_password。注意删除空格、避免引号包裹值（除非值含空格）。

　　确保Node.js版本≥16（推荐18.x LTS）：node -v验证。若未安装，使用NodeSource仓库：curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs。进入项目根目录，执行npm ci（比npm install更稳定，严格按package-lock.json还原依赖）。

　　运行npm run dev启动开发服务器。若控制台输出“Server running on http://localhost:3000”且无ERROR日志，说明后端服务已就绪。打开浏览器访问该地址，H5页面应正常加载。首次启动时，脚本通常自动执行数据库迁移（如npm run migrate），若失败，请检查migrations/目录是否存在SQL或JS迁移文件，并手动运行对应命令。

　　常见问题排查：端口被占可修改.env中PORT变量；MySQL连接拒绝请确认bind-address在/etc/mysql/mysql.conf.d/mysqld.cnf中为127.0.0.1而非0.0.0.0；SQLite写入失败多因data/目录权限不足，用ls -ld data查看并补全chmod u+w data。所有操作均无需root持续运行，项目服务建议以普通用户身份启动。

（编辑：站长网）

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