自贡档案管理系统从部署到日常使用实操全步骤指南

一、前置环境部署（必做，否则无法运行）

所有操作均在Windows 10 x64系统完成，其他系统可对应调整命令。

1. 安装JDK1.8

• 下载地址：https://download.oracle.com/otn/java/jdk/8u391-b13/jdk-8u391-windows-x64.exe，双击运行，全程默认点击下一步，安装路径选D:\Java\jdk1.8.0_391（必须指定路径，后续环境变量依赖）
• 配置环境变量：右键此电脑→属性→高级系统设置→环境变量，在系统变量中新建：
  • 变量名：JAVA_HOME，变量值：D:\Java\jdk1.8.0_391
  • 变量名：CLASSPATH，变量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
  • 编辑Path变量，新增：%JAVA_HOME%\bin
• 验证：按Win+R输入cmd，执行java -version，出现版本信息即成功。

2. 安装MySQL5.7

• 下载地址：https://cdn.mysql.com/Downloads/MySQLInstaller/mysql-installer-community-5.7.42.0.msi，双击运行，选Server only模式，安装路径选D:\MySQL\MySQL Server 5.7，数据路径选D:\MySQL\data
• 配置数据库：设置root用户密码为zg_dac@2024（必须牢记，后续部署依赖），端口默认3306
• 启动服务：按Win+R输入services.msc，找到MySQL57，右键启动并设为自动启动
• 验证：cmd执行mysql -uroot -p，输入刚才的密码，进入MySQL命令行即成功。

二、自贡档案管理系统部署

1. 下载并解压安装包

• 官方安装包地址：http://www.zgdac.gov.cn/download/zg-dams-v2.1.0.zip，解压后得到zg-dams-v2.1.0文件夹，必须解压到纯英文路径（如D:\Dams），禁止含中文，否则会导致乱码或启动失败，最终路径为D:\Dams\zg-dams-v2.1.0

2. 配置数据库连接

• 进入D:\Dams\zg-dams-v2.1.0\config目录，找到application-dev.properties，用记事本打开
• 替换为以下完整可直接运行的配置： ``` 数据库核心配置 spring.datasource.url=jdbc:mysql://localhost:3306/zg_dams?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai spring.datasource.username=root spring.datasource.password=zg_dac@2024 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver 服务端口，默认8080，若被占用可改为8081等未用端口 server.port=8080 档案存储路径，建议设为纯英文路径 dams.storage.path=D:\Dams\storage ```

3. 创建系统数据库并初始化

• cmd执行mysql -uroot -p，输入密码后，执行：CREATE DATABASE zg_dams DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• 执行初始化脚本：进入D:\Dams\zg-dams-v2.1.0\sql目录，全选init.sql内容并复制，粘贴到mysql命令行，按回车执行，无报错即初始化成功

4. 启动系统服务

• 进入D:\Dams\zg-dams-v2.1.0\bin目录，双击startup.bat，弹出黑色命令窗口，窗口不可关闭，最小化即可，等待输出“Started DamsApplication in XXXX seconds”即启动成功
• 关闭服务：双击同目录下shutdown.bat，禁止直接关闭窗口终止服务

三、日常使用操作（零门槛上手）

1. 登录系统

• 打开Chrome浏览器（版本80+），输入地址：http://localhost:8080
• 初始账号：admin，初始密码：Admin@zg123456，首次登录会强制要求修改密码，新密码需满足8-16位，包含字母、数字、特殊字符组合
• 验证登录：进入系统首页，顶部显示“自贡档案管理系统V2.1.0”标题即成功

2. 新增档案

• 左侧菜单点击“档案管理”→“新增档案”
• 必填项：档案编号、档案名称、归档日期、保管期限，其他项可留空
• 填写完成后点击“保存”，弹出“档案新增成功”提示即完成

3. 档案查询与导出

• 左侧菜单点击“档案查询”，输入任意关键词（如档案编号、名称），点击“查询”即可显示结果
• 导出Excel：查询结果右上角点击“导出”，选择本地存储路径即可生成带格式的档案清单

4. 个人中心设置

• 点击右上角用户名→“个人中心”，可修改个人信息、密码，密码修改后需重新登录生效

四、常见问题排查

• 服务无法启动：检查JDK环境变量是否正确，端口8080是否被占用（cmd执行netstat -ano|findstr 8080，若有占用，修改application-dev.properties中的server.port为未用端口）
• 数据库连接失败：确认MySQL服务已启动，密码是否与配置文件一致，数据库zg_dams是否存在
• 初始化脚本报错：确认数据库字符集为utf8mb4，无中文路径、特殊字符干扰
• 档案附件上传失败：检查dams.storage.path路径是否存在，是否有读写权限