从零搭建本地可直接部署使用的四平档案管理系统实操指南

发布时间: 2026年09月02日 11:00:03 来源: 安答联动浏览量: 0

一、前期环境准备

1.1 所需组件及准确版本

所有组件均提供直接下载地址，点击即可下载，版本必须匹配避免兼容问题：

JDK 1.8 64位：https://download.java.net/openjdk/jdk8u42-b05/openjdk-8u42-b05-windows-x64.zip
MySQL 5.7 64位：https://cdn.mysql.com/Downloads/MySQL-5.7/mysql-5.7.42-winx64.zip
Maven 3.6.3：https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.zip

1.2 环境配置步骤

Windows系统操作步骤如下，所有步骤无省略：

将三个压缩包解压到无中文无空格的路径，例如：D:\env\jdk8、D:\env\mysql5.7、D:\env\maven
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，进入配置页
新建系统变量JAVA_HOME，变量值填你的JDK解压路径，例如：D:\env\jdk8
新建系统变量MAVEN_HOME，变量值填你的Maven解压路径，例如：D:\env\maven
编辑系统变量Path，添加两行：%JAVA_HOME%\bin、%MAVEN_HOME%\bin，保存所有配置
以管理员身份打开cmd，分别输入java -version和mvn -v，能输出版本号说明配置成功

MySQL配置：进入mysql解压根目录，新建文件名为my.ini，粘贴以下内容，修改basedir和datadir为你的实际路径：

```
[mysqld]
basedir=D:\\env\\mysql5.7
datadir=D:\\env\\mysql5.7\\data
port=3306
character-set-server=utf8mb4
default-storage-engine=INNODB
sql_mode=MYSQL50,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
[client]
default-character-set=utf8mb4
port=3306
```

管理员cmd进入mysql的bin目录，依次执行以下命令：

```
mysqld --initialize-insecure
mysqld install
net start mysql
mysql -u root
set password for root@localhost = password('123456');
exit
```

完成MySQL安装启动，root账号密码为root/123456

二、获取源码与数据库初始化

2.1 获取项目源码

四平档案管理系统官方开源仓库地址：https://gitee.com/hipac/sp-archives.git，打开cmd进入你存放项目的目录，执行命令拉取：

```
git clone https://gitee.com/hipac/sp-archives.git
```

没有安装git的用户，直接打开上述链接，点击「下载ZIP」解压到本地即可。

2.2 初始化数据库

打开cmd，执行mysql -u root -p，回车后输入密码123456，进入mysql命令行
执行命令创建专属数据库：CREATE DATABASE IF NOT EXISTS sp_archives DEFAULT CHARACTER SET utf8mb4;，执行完成后退出命令行
执行导入命令，将项目自带的初始化SQL导入数据库，格式如下（替换为你本地的实际项目路径）：
```
```
mysql -u root -p123456 sp_archives < D:\code\sp-archives\doc\sp_archives.sql
```
```
没有报错就是导入成功。

三、修改配置打包启动

3.1 修改项目连接配置

打开项目目录下的src\main\resources\application.properties，删除原有内容，直接复制以下完整配置，根据你的实际情况修改密码和上传路径即可：

```
服务访问端口
server.port=8080
数据库连接配置
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/sp_archives?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=GMT%2B8
spring.datasource.username=root
spring.datasource.password=123456
MyBatis映射配置
mybatis.mapper-locations=classpath:mapper/.xml
mybatis.type-aliases-package=com.siping.archives.entity
档案附件上传路径，必须替换为你本地存在的路径
file.upload-path=D:/sp-archives/upload
```

注意：一定要提前创建上传路径对应的文件夹，否则启动会报错；MySQL密码不是123456的必须修改对应项