从零开始本地解压部署开源数字档案馆系统完整实操指南

前置准备

所需工具与资源包

所有资源均为免安装解压版，直接下载即可，无需额外执行安装程序，下载地址如下：

• JDK1.8解压版：https://cdn.azul.com/zulu/bin/zulu8.68.0.21-ca-jdk8.0.362-win_x64.zip
• MySQL5.7解压版：https://cdn.mysql.com/archives/mysql-5.7/mysql-5.7.42-winx64.zip
• 开源数字档案馆系统压缩包：https://github.com/zmfean/digital-archive/archive/refs/tags/v1.0.0.zip

解压可直接使用Windows系统自带的zip解压工具，无需额外下载第三方软件。

第一步：整理解压目录

为避免中文路径导致的启动错误，严格按照以下步骤操作：

• 打开电脑非系统盘（如D盘），新建文件夹命名为digital-archive，路径不可包含中文和空格，最终完整路径示例：D:\digital-archive
• 将下载好的三个压缩包分别解压到该目录，并重命名解压后的文件夹，最终目录结构如下：
  • D:\digital-archive\jdk：存放JDK解压文件
  • D:\digital-archive\mysql：存放MySQL解压文件
  • D:\digital-archive\archive-system：存放数字档案馆系统程序文件

第二步：配置基础环境

配置JDK环境变量

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」区域点击「新建」，变量名填写JAVA_HOME，变量值填写你的JDK解压路径，示例：D:\digital-archive\jdk，点击确定保存
• 找到系统变量中的Path变量，双击打开编辑界面，点击「新建」依次添加以下两条内容：

  

  %JAVA_HOME%\bin
  %JAVA_HOME%\jre\bin

• 依次点击所有弹窗的确定保存配置，按Win+R输入cmd打开命令行，输入java -version，输出版本号为1.8.x即为配置成功

配置并启动MySQL服务

• 进入D:\digital-archive\mysql目录，新建文本文档，重命名为my.ini（必须修改后缀名，删除默认的.txt后缀），打开后复制以下完整内容，注意替换路径为你自己的路径： ``` [mysql] default-character-set=utf8 [mysqld] port = 3306 basedir=D:\\digital-archive\\mysql datadir=D:\\digital-archive\\mysql\\data max_connections=200 character-set-server=utf8 default-storage-engine=INNODB sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES ```
• 以管理员身份打开命令提示符，执行命令进入MySQL的bin目录：cd D:\digital-archive\mysql\bin
• 依次执行以下两条命令，每条执行完成等待提示成功后再执行下一条：

  mysqld --initialize-insecure --user=mysql
  mysqld install
  

• 执行启动命令：net start mysql，提示「MySQL服务已经启动成功」即为配置完成，默认root账户无密码。

第三步：初始化系统数据库

在打开的命令行中依次执行以下操作：

1. 输入mysql -u root回车，进入数据库交互界面
2. 依次执行以下命令，每条输入后回车执行： ``` CREATE DATABASE IF NOT EXISTS digital_archive DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci; CREATE USER 'archive'@'%' IDENTIFIED BY 'Archive123!'; GRANT ALL ON digital_archive. TO 'archive'@'%'; FLUSH PRIVILEGES; EXIT; ```
3. 执行初始化表导入命令，路径与你本地路径保持一致： mysql -u root digital_archive < D:\digital-archive\archive-system\db\init.sql

执行完成无报错提示，即为数据库初始化成功。

第四步：配置系统启动参数

进入D:\digital-archive\archive-system\config目录，找到application.properties文件，用记事本打开，替换为以下完整内容即可直接使用： ``` server.port=8080 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://127.0.0.1:3306/digital_archive?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai spring.datasource.username=archive spring.datasource.password=Archive123! file.upload-path=D:/digital-archive/archive-files ```

注意：如果8080端口被其他程序占用，修改server.port=后的数字为其他未占用端口，比如8081。

第五步：启动访问系统

• 进入D:\digital-archive\archive-system目录，点击顶部地址栏输入cmd回车，打开当前目录的命令行
• 执行启动命令：java -jar digital-archive-1.0.0.jar
• 等待1-2分钟，命令行输出Started DigitalArchiveApplication即为启动成功
• 打开浏览器，输入地址http://127.0.0.1:8080即可进入系统
• 默认管理员账号：admin，默认密码：admin123

常见问题排查

• 启动提示端口占用：按照上文修改application.properties中的server.port为其他未占用端口即可
• 提示数据库连接失败：检查MySQL服务是否正常启动，my.ini中的路径是否正确，配置文件中的账号密码是否匹配
• 中文路径导致启动失败：将整个digital-archive文件夹移动到无中文、无空格的路径下，重新修改JDK环境变量和my.ini中的路径即可