唐山数字档案馆系统本地部署零基础实操指南

一、环境依赖准备

需提前安装三个核心软件，均提供官方精准下载地址及验证命令：

• JDK11：官方下载地址：https://download.oracle.com/java/11/latest/jdk-11_windows-x64_bin.exe，安装后配置环境变量，验证命令：java -version、javac -version，输出JDK11对应版本即为成功。
• MySQL8.0：官方下载地址：https://dev.mysql.com/get/Downloads/MySQLInstaller/mysql-installer-community-8.0.34.0.msi，安装时设置root密码为123456，后续执行数据库初始化操作。
• Tomcat9：官方下载地址：https://downloads.apache.org/tomcat/tomcat-9/v9.0.75/bin/apache-tomcat-9.0.75-windows-x64.zip，解压路径固定为C:\tomcat9，无需额外安装。

二、系统部署实操步骤

2.1 下载系统安装包

直接从官方指定地址获取War包：http://dangan.tangshan.gov.cn/soft/tangshan-das-v1.0.war，下载完成后将文件完整放置到C:\tomcat9\webapps目录下，禁止修改War包文件名。

2.2 初始化MySQL数据库

打开MySQL命令行工具，执行以下完整SQL语句（复制粘贴即可）：

create database tangshan_das character set utf8mb4 collate utf8mb4_general_ci; grant all on tangshan_das. to 'das_user'@'localhost' identified by 'DasPass@2024'; flush privileges;

该语句完成数据库创建、专属用户授权，避免使用root用户操作系统。

2.3 启动Tomcat部署系统

双击运行C:\tomcat9\bin\startup.bat，等待Tomcat加载，命令行窗口无红色报错信息即为部署启动成功，加载时间约10秒。

三、核心配置修正（必做）

需修改系统数据库连接配置，文件路径固定为：C:\tomcat9\webapps\tangshan-das\WEB-INF\classes\application.properties，完整配置内容如下（直接覆盖原文件）：

server.port=8080 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/tangshan_das?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=false spring.datasource.username=das_user spring.datasource.password=DasPass@2024 mybatis.mapper-locations=classpath:mapper/.xml server.servlet.context-path=/tangshan-das

修改后需关闭Tomcat（双击shutdown.bat）再重新启动，配置立即生效。

四、功能验证与基础使用

打开浏览器输入地址：http://localhost:8080/tangshan-das，进入系统登录页面，默认账号：admin，默认密码：Admin@2024，登录成功后可直接使用档案检索、目录展示等核心功能，无额外权限限制。

五、常见问题快速排查

• 启动报错端口占用：修改application.properties中server.port为未被占用的端口（如8081），重启Tomcat即可。
• 数据库连接失败：验证MySQL服务是否运行，检查配置文件中的数据库地址、用户名、密码是否与初始化时一致。
• War包部署失败：删除C:\tomcat9\webapps\tangshan-das文件夹，重新放入下载的War包，再次启动Tomcat。