清明纪念·时光信笺——项目运行指南

本教程让 清明纪念·时光信笺 项目在本地跑起来！

以下提供Mac本地运行的详细步骤（Win也是类似）：

1. 环境准备

请确保您的Mac上已经安装了以下软件：

JDK 11+ (可以通过 java -version 检查)
Maven 3.6+ (可以通过 mvn -version 检查)
Node.js 16+ (可以通过 node -v 检查)
MySQL 5.7+ / 8.0 (可以通过 mysql --version 检查)

2. 数据库配置

2.1 启动MySQL服务

首先确保MySQL服务已经启动：

bash 复制代码

# 如果使用Homebrew安装的MySQL
brew services start mysql

2.2 创建数据库和用户

登录MySQL并创建数据库和用户：

bash 复制代码

mysql -u root -p

在MySQL命令行中执行：

sql 复制代码

-- 创建数据库
CREATE DATABASE IF NOT EXISTS timeletter DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 可选：创建用户（如果需要）
-- CREATE USER 'timeletter'@'localhost' IDENTIFIED BY 'your_password';
-- GRANT ALL PRIVILEGES ON timeletter.* TO 'timeletter'@'localhost';
-- FLUSH PRIVILEGES;

2.3 初始化数据库表结构

执行项目根目录下的 init.sql 脚本：

bash 复制代码

mysql -u root -p timeletter < init.sql

3. 后端配置

3.1 修改数据库连接配置

编辑 backend/src/main/resources/application.yml 文件，修改数据库连接信息：

yaml 复制代码

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/timeletter?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root  # 替换为您的MySQL用户名
    password: 123456  # 替换为您的MySQL密码

3.2 跳过短信服务配置（可选）

如果您暂时没有阿里云短信服务的AccessKey，可以暂时跳过短信服务配置，项目仍能运行，但短信功能将不可用。

4. 前端配置

前端配置基本无需修改，默认已经配置好代理到后端服务。

5. 启动项目

5.1 启动后端服务

bash 复制代码

cd backend
mvn clean compile spring-boot:run

后端服务将在 http://localhost:8080 启动

5.2 启动前端服务

在另一个终端窗口中执行：

bash 复制代码

cd frontend
npm install  # 第一次运行需要安装依赖
npm run dev

前端服务将在 http://localhost:3000 启动

6. 访问项目

打开浏览器访问 http://localhost:3000 查看前端页面
后端API文档可以通过 http://localhost:8080/api/{endpoint} 访问
后台管理页面可以通过 http://localhost:3000/admin 访问，默认用户名/密码：admin/123456

7. 常见问题解决

7.1 数据库连接失败

确保MySQL服务已经启动
检查用户名和密码是否正确
检查数据库名称是否正确

7.2 依赖安装失败

后端依赖失败：检查网络连接，或尝试使用国内镜像源

bash 复制代码

mvn clean compile -Dmaven.wagon.http.ssl.insecure=true -Dmaven.wagon.http.ssl.allowall=true

前端依赖失败：检查网络连接，或尝试使用淘宝镜像
bash 复制代码
```
npm config set registry https://registry.npmmirror.com
npm install
```

7.3 端口被占用

可以修改后端端口：在 application.yml 中添加 server.port: 8081
可以修改前端端口：在 vite.config.js 中修改 port 配置

8. 项目功能验证

纪念留言板：可以发布留言并查看
未来信：可以填写并提交，虽然短信功能可能不可用，但可以在后台查看提交的记录
后台管理：可以登录并管理留言和未来信

项目源码地址请与我沟通~