退役军人事务部门档案管理软件部署与基础操作全指南

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

部署前环境准备

必备软件版本及下载地址

需安装以下指定版本软件，避免兼容性问题：

JDK 1.8.0_301：国内镜像下载地址 https://mirrors.tuna.tsinghua.edu.cn/AdoptOpenJDK/8/jdk/x64/windows/OpenJDK8U-jdk_x64_windows_hotspot_8u301b09.msi
MySQL 5.7.36：官方归档下载地址 https://downloads.mysql.com/archives/get/p/25/file/mysql-5.7.36-winx64.zip
Node.js 14.17.6：官网下载地址 https://nodejs.org/dist/v14.17.6/node-v14.17.6-x64.msi

环境配置验证

安装完成后打开Windows CMD，执行以下命令验证：

java -version，输出应为 java version "1.8.0_301"
mysql -V，输出应为 mysql Ver 14.14 Distrib 5.7.36
node -v，输出应为 v14.17.6

验证不通过时，需检查系统环境变量是否配置对应软件的安装路径。

软件部署实操步骤

获取系统代码仓库

打开CMD，执行命令克隆适配后的系统代码：

git clone https://gitee.com/opensourceveteran/archive-management-system.git

执行完成后，当前目录会生成 archive-management-system 文件夹。

MySQL数据库初始化

打开CMD，登录MySQL：

mysql -u root -p

输入MySQL root用户密码后，执行以下命令创建系统所需数据库：

CREATE DATABASE veteran_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

执行 exit 退出MySQL。

后端服务部署

进入后端代码目录：

退役军人事务部门档案管理软件部署与基础操作全指南

cd archive-management-system/backend

打开项目根目录下的 application.yml 配置文件，修改数据库连接信息，完整配置如下：

server:
port: 8080
spring:
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://localhost:3306/veteran_archive?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
username: root
password: YOUR_MYSQL_ROOT_PASSWORD
jpa:
hibernate:
ddl-auto: update
show-sql: false

将配置中 YOUR_MYSQL_ROOT_PASSWORD 替换为自己的MySQL root密码，保存文件后，执行后端启动命令：

mvn spring-boot:run

等待控制台输出 Started ArchiveSystemApplication in X.XXX seconds，表示后端服务启动成功。

前端服务部署

切换到前端代码目录：

cd ../frontend

安装前端依赖，使用国内镜像加速：

npm install --registry=https://registry.npm.taobao.org

依赖安装完成后，启动前端服务：

npm run serve

服务启动后，浏览器访问 http://localhost:8081，进入系统登录页，默认账号为 admin，默认密码为 admin123。

核心档案操作指南

新增退役军人档案

登录系统后，点击左侧菜单 档案管理 -> 新增档案，进入录入页，需填写以下必填字段：

姓名：与身份证完全一致，不可为空
身份证号：18位格式，系统自动校验合法性
入伍时间：精确到年月日，需晚于出生日期
退役时间：精确到年月日，需晚于入伍时间

所有字段填写完成后，点击保存，系统自动生成唯一档案编号，新增完成。

档案查询与导出

点击左侧菜单 档案查询，在搜索栏输入任意关键词（姓名、身份证号、部队编号等），点击查询，结果列表将展示匹配记录。点击列表右上角 导出Excel，可将当前查询结果导出为Excel文件，支持批量导出全部符合条件的档案。

常见问题快速排查

后端启动失败，提示数据库连接失败：检查MySQL服务是否已启动，Windows服务中找到MySQL57服务，右键选择启动；再核对 application.yml 中的用户名、密码是否正确，数据库名是否为 veteran_archive。
前端加载缓慢或依赖安装失败：重新执行 npm install --registry=https://registry.npm.taobao.org --force，强制重新安装依赖，避免缓存问题。
新增档案时提示身份证号重复：系统会自动校验身份证号唯一性，可返回 档案查询 页输入该身份证号，确认是否已存在记录，若为误判，需清理浏览器缓存后重试。