一、Litemall项目简介与部署前准备

Litemall是一款基于Spring Boot和Vue.js开发的开源商城系统，包含移动端、管理端和后端服务，适合中小型电商项目快速搭建。在Linux上部署Litemall需提前准备以下内容：

1. 服务器环境：推荐使用CentOS 7/8或Ubuntu 20.04 LTS，确保系统为最新稳定版。
2. 基础工具：安装git、wget、curl等工具，用于代码下载和依赖管理。
3. Java环境：Litemall后端依赖Java 8或11，需安装OpenJDK或Oracle JDK。可通过以下命令安装OpenJDK 11：

   sudo apt update && sudo apt install openjdk-11-jdk -y  # Ubuntu
   sudo yum install java-11-openjdk-devel -y              # CentOS

4. 数据库：项目默认使用MySQL 5.7+，需提前安装并配置字符集为utf8mb4。
5. Node.js与npm：前端构建需要Node.js 12+和npm 6+，可通过nvm管理多版本。

二、数据库配置与初始化

1. 安装MySQL：

   sudo apt install mysql-server -y          # Ubuntu
   sudo yum install mysql-community-server -y # CentOS
   sudo systemctl start mysqld

2. 创建数据库与用户：

   CREATE DATABASE litemall CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   CREATE USER 'litemall'@'localhost' IDENTIFIED BY 'your_password';
   GRANT ALL PRIVILEGES ON litemall.* TO 'litemall'@'localhost';
   FLUSH PRIVILEGES;

3. 导入初始数据：从项目sql目录找到litemall.sql文件，执行导入：

   mysql -ulitemall -p litemall < /path/to/litemall.sql

三、后端服务部署

1. 下载项目代码：

   git clone https://github.com/linlinjava/litemall.git
   cd litemall

2. 修改数据库配置：编辑litemall-admin-api/src/main/resources/application.yml，更新以下内容：

   spring:
     datasource:
       url: jdbc//localhost:3306/litemall?useSSL=false&serverTimezone=UTC
       username: litemall
       password: your_password

3. 编译打包：

   cd litemall-admin-api
   mvn clean package -DskipTests

   生成的litemall-admin-api-x.x.x.jar位于target目录。

4. 启动服务：

   java -jar target/litemall-admin-api-x.x.x.jar

   或使用后台运行：

   nohup java -jar target/litemall-admin-api-x.x.x.jar > litemall.log 2>&1 &

四、前端项目构建与部署

1. 安装Node.js依赖：

   cd litemall-admin  # 管理端
   npm install

2. 修改API请求地址：编辑src/config/index.js，更新baseURL为后端服务IP（如http://your_server_ip:8080）。

3. 构建生产环境代码：

   npm run build

   生成的静态文件位于dist目录。

4. 部署静态文件：可使用Nginx作为反向代理，配置示例如下：

   server {
       listen 80;
       server_name your_domain.com;
       root /path/to/litemall-admin/dist;
       index index.html;
       location /api/ {
           proxy_pass http://localhost:8080/;
       }
   }

   重启Nginx：

   sudo systemctl restart nginx

五、常见问题与优化建议

1. 端口冲突：确保8080（后端）和80（前端）端口未被占用，可通过netstat -tulnp检查。
2. 内存不足：若服务器内存较小，可在启动JVM时添加参数限制内存：

   java -Xms256m -Xmx512m -jar target/litemall-admin-api-x.x.x.jar

3. 日志管理：建议使用logback或log4j2配置日志滚动策略，避免日志文件过大。
4. 安全加固：
   • 修改MySQL默认端口和root密码。
   • 配置防火墙仅开放必要端口（如80、443、8080）。
   • 定期备份数据库和代码。

六、项目启动与验证

1. 访问管理端：浏览器打开http://your_server_ip，输入默认账号admin和密码admin123登录。
2. 检查API服务：通过curl http://localhost:8080/api/auth/admin/info验证后端接口是否正常响应。
3. 监控服务状态：使用systemctl或ps命令检查Java和Nginx进程是否运行。

七、扩展与持续集成

1. 自动化部署：可结合Jenkins或GitLab CI实现代码提交后自动构建、测试和部署。
2. 容器化部署：使用Docker简化环境依赖，示例Dockerfile如下：

   FROM openjdk:11-jre
   COPY target/litemall-admin-api-x.x.x.jar /app.jar
   EXPOSE 8080
   CMD ["java", "-jar", "/app.jar"]

   构建并运行：

   docker build -t litemall .
   docker run -d -p 8080:8080 litemall

通过以上步骤，Litemall项目可在Linux环境下稳定运行。开发者可根据实际需求调整配置，例如添加Redis缓存、配置SSL证书或接入第三方支付服务。部署过程中需注意版本兼容性，建议使用相同主版本的依赖库以避免冲突。