SpringBoot+达梦+Vue实现档案管理系统国产化改造全流程
一、国产化环境准备与基础组件安装
本文档基于银河麒麟V10服务器版进行实操演示,旨在将现有的档案管理系统平滑迁移至国产化技术栈。我们需要在服务器上配置好基础运行环境,包括JDK、Redis和Nginx。
1.1 JDK环境配置
档案管理系统后端通常基于Spring Boot,依赖Java环境。麒麟系统默认自带OpenJDK,但为了稳定性,建议手动安装JDK 1.8。
执行以下命令进行安装和环境变量配置:
安装 JDK 1.8
yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
验证安装版本
java -version
配置全局环境变量
echo 'export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk' >> /etc/profile
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile
source /etc/profile
1.2 Nginx与Redis服务部署
前端静态资源需要Nginx托管,后端缓存依赖Redis。使用yum直接安装:
安装 Nginx 和 Redis
yum install -y nginx redis
启动并设置开机自启
systemctl start redis
systemctl enable redis
systemctl start nginx
systemctl enable nginx
测试 Redis 连接
redis-cli ping
返回 PONG 则表示正常
二、达梦数据库安装与初始化
数据库国产化改造的核心是将MySQL/Oracle替换为达梦数据库(DM8)。达梦数据库在语法上高度兼容Oracle,适配相对平滑。
2.1 达梦数据库安装部署
将达梦数据库安装包(如dm8_setup.rpm)上传至服务器/opt目录下。执行以下命令进行静默安装:
进入安装包目录
cd /opt
执行安装命令,默认安装路径为/opt/dmdbms
rpm -ivh dm8_setup.rpm
初始化环境变量
source /etc/profile
安装完成后,需要使用DM提供的初始化工具来创建数据库实例。假设我们将数据存放在/data/dmdata目录:
创建数据目录
mkdir -p /data/dmdata
执行初始化脚本(路径根据实际安装情况可能微调)
cd /opt/dmdbms/bin
./dminit path=/data/dmdata page_size=16 charset=1 case_sensitive=0
注册并启动服务
./dm_service_installer.sh -t dmserver -p DMSERVER -i /data/dmdata/dm.ini
systemctl start DmServiceDMSERVER
systemctl enable DmServiceDMSERVER
2.2 数据库实例创建与表结构导入
使用达梦自带的管理工具disql连接数据库并创建专用表空间和用户。注意:达梦默认端口号为5236。
连接数据库
./disql sysdba/SYSDBA
在 disql 命令行中执行以下 SQL:
创建表空间
CREATE TABLESPACE ARCHIVE_TB DATAFILE '/data/dmdata/ARCHIVE_TB.DBF' SIZE 128 AUTOEXTEND ON NEXT 32 MAXSIZE UNLIMITED;
创建档案管理专用用户
CREATE USER ARCHIVE_USER IDENTIFIED BY "Archive@2024" DEFAULT TABLESPACE ARCHIVE_TB;
授权
GRANT RESOURCE, PUBLIC, VTi TO ARCHIVE_USER;
GRANT CREATE VIEW TO ARCHIVE_USER;
exit;
接下来,将原有的MySQL建表SQL转换为达梦语法。大部分标准SQL无需修改,主要调整自增主键和特定函数。建议使用达梦自带的DM数据迁移工具(DTS)进行图形化迁移,或者手动执行转换后的SQL脚本:
再次登录以执行业务脚本
./disql ARCHIVE_USER/Archive@2024
执行建表脚本(示例)
start /opt/archive_schema.sql
exit;
三、后端服务国产化适配改造
后端改造主要集中在Maven依赖和数据库配置文件上,无需修改大量业务代码。
3.1 Maven依赖与驱动替换
在项目的pom.xml中,移除MySQL或Oracle的驱动依赖,添加达梦JDBC驱动。如果本地Maven仓库没有达梦驱动,需要手动安装DM安装包下drivers/jdbc/DmJdbcDriver18.jar到本地仓库。
com.dameng
DmJdbcDriver18
8.1.2.192
3.2 数据源配置与代码兼容性调整
修改application.yml或application.properties,将数据源信息替换为达梦数据库的配置。

spring:
datasource:
达梦驱动类名
driver-class-name: dm.jdbc.driver.DmDriver
URL格式:jdbc:dm://ip:port
url: jdbc:dm://127.0.0.1:5236?ARCHIVE_USER
username: ARCHIVE_USER
password: Archive@2024
代码兼容性注意点:
- 如果使用了MyBatis-Plus,需确保分页插件配置正确,达梦支持标准的分页语法。
- 检查代码中的
DATE_FORMAT等MySQL特有函数,达梦通常使用TO_CHAR或标准SQL语法。 - 若实体类主键策略为
IDENTITY,达梦同样支持自增,但建表时需指定IDENTITY(1,1)。
配置完成后,使用Maven打包:
mvn clean package -Dmaven.test.skip=true
四、前端工程构建与Nginx反向代理配置
前端部分主要是调整接口请求地址,并通过Nginx进行高效部署。
4.1 前端环境构建
进入前端项目根目录,修改生产环境的接口配置地址(通常在.env.production文件中),将其指向后端服务地址。
示例:.env.production
VUE_APP_BASE_API = 'http://192.168.1.100:8080'
执行构建命令生成静态资源:
npm install
npm run build
构建完成后,将dist目录下的所有文件上传至服务器的/usr/share/nginx/html/archive/目录(建议创建独立子目录)。
在服务器上创建目录
mkdir -p /usr/share/nginx/html/archive
上传文件后,确保权限正确
chown -R nginx:nginx /usr/share/nginx/html/archive
chmod -R 755 /usr/share/nginx/html/archive
4.2 Nginx反向代理配置
编辑Nginx配置文件,设置反向代理解决跨域问题,并配置前端路由History模式支持。
vi /etc/nginx/conf.d/archive.conf
输入以下完整配置内容:
server {
listen 80;
server_name localhost;
前端静态资源根目录
root /usr/share/nginx/html/archive;
index index.html;
后端接口代理
location /prod-api/ {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
Vue Router History模式配置,防止刷新404
location / {
try_files $uri $uri/ /index.html;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
}
测试配置文件语法并重载Nginx:
nginx -t
systemctl reload nginx
五、系统启动与功能验证
启动后端Java服务,并进行全链路功能验证。
5.1 后端服务启动
将打包好的Jar包上传至服务器/opt/app目录,使用nohup命令后台启动。
mkdir -p /opt/app
假设 jar 包名为 archive-system.jar
cd /opt/app
启动服务
nohup java -jar archive-system.jar --server.port=8080 > /opt/app/app.log 2>&1 &
查看启动日志,确保 "Started ArchiveApplication" 字样出现
tail -f /opt/app/app.log
5.2 功能验证
打开浏览器,访问服务器IP地址:http://服务器IP。
- 登录验证:输入管理员账号密码,检查是否能成功请求后端接口并获取Token。
- 档案列表查询:进入档案管理模块,验证列表数据能否正常从达梦数据库读取并展示。
- 新增档案:执行新增操作,验证数据写入达梦数据库,且主键自增正常。
- 文件上传下载:测试附件上传功能,检查文件存储路径权限及下载流是否正常。
若所有功能测试通过,即表示档案管理系统已成功完成国产化版改造与部署。