三甲医院版综合档案管理系统本地快速部署全流程实操指南

一、部署前提条件准备

以下为硬性要求，缺一不可，提前核对避免卡壳

• 服务器/本地PC配置：CPU i5-10400及以上/4核8G及以上，内存16G及以上，硬盘SSD 256G+（含100G以上系统盘+150G以上数据盘）
• 操作系统：Windows Server 2019 Standard 64位（可选择阿里云盘天翼云盘镜像站下载：https://mirrors.aliyun.com/windows-server/2019-zh-cn/standard/ 或本地正版介质）
• 基础环境包：提前下载到本地数据盘根目录

基础环境包下载清单（附官方/镜像站直链）

• JDK 1.8.0_391（Tomcat 9.x专属适配，镜像站：https://repo.huaweicloud.com/java/jdk/8u391-b09/jdk-8u391-windows-x64.exe）
• Apache Tomcat 9.0.85（稳定版，镜像站：https://repo.huaweicloud.com/apache/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85-windows-x64.zip）
• MySQL 8.0.36 Community Server（三甲医疗数据合规推荐，镜像站：https://repo.huaweicloud.com/mysql/Downloads/MySQL-8.0/mysql-8.0.36-winx64.zip）
• 综合档案管理系统三甲医院版v2.1.3（模拟合规版，下载链接：https://github.com/LiuXianSen123/medical-archive-simulator/releases/download/v2.1.3/medical-archive-3A.war）

二、基础环境安装与配置

2.1 JDK 1.8.0_391的安装与环境变量配置

1. 双击打开数据盘根目录下的jdk-8u391-windows-x64.exe

2. 点击“下一步”→ 取消勾选“公共JRE”→ 点击“更改”将安装目录修改为D:\Java\jdk1.8.0_391→ 点击“下一步”完成安装

3. 环境变量配置：

• 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”
• 系统变量区域点击“新建”：
  • 变量名：JAVA_HOME
  • 变量值：D:\Java\jdk1.8.0_391
• 系统变量区域找到“Path”→“编辑”→“新建”→ 输入%JAVA_HOME%\bin→ 点击“上移”到列表顶部→ 连续点击“确定”保存

4. 验证安装：按Win+R输入cmd打开命令提示符，输入java -version，出现“java version "1.8.0_391"”即成功

2.2 MySQL 8.0.36的安装与初始化

1. 解压mysql-8.0.36-winx64.zip到D:\MySQL目录

2. 在D:\MySQL目录下新建文本文档，重命名为my.ini，用记事本打开粘贴以下完整配置：

```ini [mysqld] 设置3306端口 port=3306 设置mysql的安装目录 basedir=D:\MySQL 设置mysql数据库的数据的存放目录 datadir=D:\MySQL\Data 允许最大连接数 max_connections=200 允许连接失败的次数。防止有人从该主机试图攻击数据库系统 max_connect_errors=10 服务端使用的字符集默认为UTF8MB4 character-set-server=utf8mb4 创建新表时将使用的默认存储引擎 default-storage-engine=INNODB 默认使用“mysql_native_password”插件认证（适配v2.1.3版档案系统） default_authentication_plugin=mysql_native_password [mysql] 设置mysql客户端默认字符集 default-character-set=utf8mb4 [client] 设置mysql客户端连接服务端时默认使用的端口 port=3306 default-character-set=utf8mb4 ```

3. 初始化MySQL：以管理员身份打开cmd，输入以下命令逐行执行：

```cmd cd D:\MySQL\bin mysqld --initialize --console ```

4. 记下控制台输出的临时密码（格式为root@localhost: xxxxxxxx，不含冒号前的空格）

5. 注册并启动MySQL服务：继续逐行执行：

```cmd mysqld --install MySQL80 net start MySQL80 ```

6. 修改root密码：继续逐行执行，输入临时密码时不会显示字符，直接粘贴后回车：

```cmd mysql -u root -p ALTER USER 'root'@'localhost' IDENTIFIED BY 'Medical@Archive2024'; FLUSH PRIVILEGES; exit ```

2.3 Apache Tomcat 9.0.85的安装与端口调整

1. 解压apache-tomcat-9.0.85-windows-x64.zip到D:\Tomcat9目录

2. 调整HTTP端口为80（三甲医院内网常用端口）：打开D:\Tomcat9\conf\server.xml，找到第69行左右的：

```xml ```

将port="8080"修改为port="80"，保存文件

3. 注册并启动Tomcat服务：以管理员身份打开cmd，逐行执行：

```cmd cd D:\Tomcat9\bin service.bat install net start Tomcat9 ```

4. 验证启动：在服务器/本地PC浏览器输入http://localhost，出现Tomcat猫图案即成功

三、综合档案管理系统部署

3.1 数据库导入

1. 以管理员身份打开cmd，进入MySQL bin目录：

```cmd cd D:\MySQL\bin mysql -u root -pMedical@Archive2024 ```

2. 创建医疗档案专属数据库：

```sql CREATE DATABASE medical_archive_3a DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; FLUSH PRIVILEGES; exit ```

3. 模拟合规版自带初始化SQL脚本（需先解压medical-archive-3A.war到临时目录D:\Temp）：

• 在数据盘根目录新建Temp文件夹
• 将medical-archive-3A.war重命名为medical-archive-3A.zip，解压到D:\Temp
• 找到D:\Temp\WEB-INF\classes\sql\init_3a.sql脚本

4. 导入脚本到数据库：以管理员身份打开cmd，逐行执行：

```cmd cd D:\MySQL\bin mysql -u root -pMedical@Archive2024 medical_archive_3a < D:\Temp\WEB-INF\classes\sql\init_3a.sql ```

3.2 系统配置文件修改

1. 打开D:\Temp\WEB-INF\classes\application.yml（无该文件则检查是否解压正确），用记事本打开替换以下内容，保存：

```yaml server: port: 8080 servlet: context-path: /medical-archive spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/medical_archive_3a?useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai&useSSL=false username: root password: Medical@Archive2024 jpa: hibernate: ddl-auto: update show-sql: false properties: hibernate: format_sql: true dialect: org.hibernate.dialect.MySQL8Dialect 医疗档案专属存储路径 file: upload-path: D:\Medical-Archive-Files ```

3.3 WAR包重新打包与部署

1. 重新打包WAR包（无需额外工具，使用Windows自带压缩功能）：

• 进入D:\Temp目录，全选所有文件（Web-INF、META-INF等）
• 右键→“发送到”→“压缩(zipped)文件夹”
• 重命名压缩包为medical-archive-3A.war

2. 部署WAR包：

• 停止Tomcat服务：管理员cmd输入net stop Tomcat9
• 删除D:\Tomcat9\webapps下的所有文件和文件夹
• 将重新打包的medical-archive-3A.war复制到D:\Tomcat9\webapps目录

四、系统启动与验证

4.1 启动Tomcat服务

管理员cmd输入net start Tomcat9，等待约2-3分钟（首次启动会初始化部分业务数据）

4.2 访问系统并测试功能

• 访问地址：http://服务器IP/medical-archive（本地测试用http://localhost/medical-archive）
• 管理员账号密码：admin / Admin@Archive2024
• 测试核心功能：新建门诊档案、上传病历文件、查询档案（需先在D盘创建D:\Medical-Archive-Files文件夹）

五、常见问题快速排查

• Tomcat启动失败：检查端口80是否被占用（管理员cmd输入netstat -ano | findstr "80"，找到PID后在任务管理器结束对应进程）
• 系统无法登录：检查application.yml中数据库账号密码是否正确，MySQL服务是否启动
• 文件无法上传：检查是否创建D:\Medical-Archive-Files文件夹，是否授予Users组完全控制权限