百色数字档案馆系统本地部署零基础全流程实操指南

一、前置环境要求

需在Windows 10/11 64位系统部署，依赖软件及下载地址如下：

• OpenJDK 11 下载地址：https://download.java.net/java/ga/jdk11/openjdk-11.0.2_windows-x64_bin.zip
• MySQL 8.0.34 下载地址：https://dev.mysql.com/get/Downloads/MySQLInstaller/mysql-installer-community-8.0.34.0.msi
• 百色数字档案馆系统安装包 下载地址：http://bsdag.gov.cn/software/bs-archive-system-v1.2.1-release.zip

核心要求：所有安装包必须保存至非中文、无空格路径，严禁放在桌面或C:\Users\用户名下，否则会导致权限或路径错误。

二、安装OpenJDK 11

2.1 解压安装包

将下载的OpenJDK压缩包解压至 C:\java\jdk11，完成后确认路径为 C:\java\jdk11\bin 存在。

2.2 配置环境变量

右键“此电脑”→属性→高级系统设置→环境变量，按以下步骤配置：

• 新建系统变量：变量名 JAVA_HOME，变量值 C:\java\jdk11
• 编辑系统变量Path，新增 %JAVA_HOME%\bin

2.3 验证安装

按Win+R输入cmd打开命令行，执行命令：java -version，输出必须包含“openjdk version "11.0.2"”，若版本错误请重新配置环境变量。

三、安装MySQL 8.0.34并创建数据库

3.1 安装MySQL

运行MySQL安装包，选择“Server only”安装类型，点击Next；设置root密码为 123456（部署时用简单密码避免后续配置出错），后续步骤保持默认，完成安装后自动启动MySQL服务。

3.2 创建业务数据库

命令行执行命令登录MySQL：mysql -u root -p，输入密码 123456，进入MySQL后执行以下完整命令：

```sql CREATE DATABASE bs_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ```

必须确认数据库名是bs_archive，编码为utf8mb4，否则系统启动后会出现乱码或功能异常。

四、部署百色数字档案馆系统

4.1 解压系统包

将下载的系统安装包解压至 D:\bs-archive，完成后路径为 D:\bs-archive\config 存在。

4.2 修改数据库连接配置

用记事本打开配置文件 D:\bs-archive\config\application-dev.yml，替换以下内容为自己的配置（无需修改其他内容）：

```yaml spring: datasource: url: jdbc:mysql://localhost:3306/bs_archive?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 123456 server: port: 8080 ```

重点确认：密码需与MySQL设置的root密码一致，时区为Asia/Shanghai，端口默认8080，若端口被占用可修改为8081。

4.3 启动系统

进入 D:\bs-archive\bin，双击 startup.bat 文件，弹出命令行窗口后不要关闭，等待窗口出现“Started BsArchiveApplication in X seconds”提示，说明系统启动成功。

五、验证系统正常运行

打开任意浏览器，输入地址：http://localhost:8080，进入登录页面，使用默认账号密码登录：账号 admin，密码 admin123。首次登录必须立即修改默认密码，避免安全风险。

六、常见问题排查

• 启动失败：检查命令行窗口的错误提示，若为JDK版本错误，重新确认java -version为11；若为数据库连接错误，检查MySQL服务是否启动、配置文件密码是否正确。
• 页面无法访问：执行命令 netstat -ano | findstr 8080，若输出不为空说明端口被占用，修改配置文件的server.port为其他端口（如8081），重启startup.bat。
• 中文乱码：检查MySQL数据库编码是否为utf8mb4，配置文件url的characterEncoding是否为utf8mb4。