小白信创：OpenEuler24.03+JeecgBoot 3.8.3 部署全流程（通关版）

小白信创OpenEuler24.03JeecgBoot 3.8.3 部署全流程通关版最近工作场所施工拖了好久才又继续折腾部署这次通关了后续会在此基础上架构我的资产管理系统这篇基本就能解决从零部署的大部分问题。 目录环境准备与软件安装PostgreSQL 安装与配置拉取 JeecgBoot 源码执行建表语句重要调整 docker-compose.yml编译后端与前端Docker 容器化部署登录验证踩坑记录全集附录一键环境检查脚本1. 环境准备与软件安装1.1 安装基础软件# 更新系统dnf update-y# 安装基础工具dnfinstall-yvimwgetcurlgit# 安装 JDK 17dnfinstall-yjava-17-openjdk java-17-openjdk-devel# 安装 Mavendnfinstall-ymaven# 安装 Node.js 20dnfinstall-ynodejs# 安装 pnpm前端包管理器npminstall-gpnpm# 验证安装java-versionmvn-versionnode-vpnpm-v1.2 安装 Docker 和 Docker Compose# 安装 Dockerdnfinstall-ydocker-ce docker-ce-cli containerd.io docker-compose-plugin--nogpgcheck# 启动 Dockersystemctlenable--nowdocker# 配置国内镜像加速重要避免拉取超时mkdir-p/etc/dockercat/etc/docker/daemon.jsonEOF { registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com, https://mirror.baidubce.com ] } EOFsystemctl restartdocker# 验证docker--versiondockercompose version1.3 安装 yqYAML 处理工具# 下载预编译二进制wget-O/usr/local/bin/yq https://mirror.ghproxy.com/https://github.com/mikefarah/yq/releases/download/v4.44.3/yq_linux_amd64chmodx /usr/local/bin/yq yq--version2. PostgreSQL 安装与配置2.1 安装 PostgreSQL 17# 查看可用版本dnf list available--enablerepoEPOL|greppostgresql-17# 安装dnfinstall-ypostgresql-17-server2.2 初始化并启动# 初始化数据库/usr/bin/postgresql-setup--initdb--unitpostgresql17# 启动并设置开机自启systemctlenable--nowpostgresql17# 查看状态systemctl status postgresql172.3 设置数据库密码sudo-upostgres psql-cALTER USER postgres WITH PASSWORD 你的数据库密码;2.4 配置远程访问# 修改监听地址sed-is/#listen_addresses localhost/listen_addresses *//var/lib/pgsql/17/data/postgresql.conf# 添加 Docker 网段到 pg_hba.confechohost all all 172.16.0.0/12 md5/var/lib/pgsql/17/data/pg_hba.conf# 重启systemctl restart postgresql17# 防火墙放行firewall-cmd --add-port5432/tcp--permanentfirewall-cmd--reload2.5 创建 JeecgBoot 数据库PGPASSWORD你的数据库密码psql-Upostgres-hlocalhost-cCREATE DATABASE jeecg_boot WITH OWNER postgres ENCODING UTF8 LC_COLLATEC LC_CTYPEC TEMPLATEtemplate0;3. 拉取 JeecgBoot 源码# 拉取 v3.8.3last 标签最后一个 Spring Boot 2 版本gitclone--branchv3.8.3last https://gitee.com/jeecg/JeecgBoot.gitcdJeecgBoot# 确认版本gitdescribe--tags预期输出v3.8.3last4. 执行建表语句重要⚠️ 必须在容器化之前执行否则启动时会因找不到核心表而报错。cd~/JeecgBoot/jeecg-boot/db/其他数据库脚本/# 确认脚本存在ls-lhjeecgboot-postgresql17.sql# 执行建表PGPASSWORD你的数据库密码psql-Upostgres-hlocalhost-djeecg_boot-fjeecgboot-postgresql17.sql4.1 验证表数量PGPASSWORD你的数据库密码psql-Upostgres-hlocalhost-djeecg_boot-c\dt|wc-l预期输出119 张表5. 调整 docker‑compose.yml5.1 使用 yq 修改配置cd~/JeecgBoot# 1. 删除 MySQL 服务yq-idel(.services.jeecg-boot-mysql)docker-compose.yml# 2. 删除 pgvector 服务如不需要 AIyq-idel(.services.jeecg-boot-pgvector)docker-compose.yml# 3. 重命名 Redis 服务yq-iwith(.services; .[redis] .[jeecg-boot-redis] | del(.[jeecg-boot-redis]))docker-compose.yml yq-i.services.redis.container_name redisdocker-compose.yml yq-idel(.services.redis.hostname)docker-compose.yml# 4. 移除对 MySQL 的依赖yq-idel(.services.jeecg-boot-system.depends_on[] | select(. jeecg-boot-mysql))docker-compose.yml# 5. 添加环境变量yq-i.services.jeecg-boot-system.environment { SPRING_DATASOURCE_URL: jdbc:postgresql://服务器IP:5432/jeecg_boot, SPRING_DATASOURCE_USERNAME: postgres, SPRING_DATASOURCE_PASSWORD: 你的数据库密码, SPRING_DATASOURCE_DRIVER_CLASS_NAME: org.postgresql.Driver, SPRING_REDIS_HOST: redis, SPRING_REDIS_PORT: 6379 }docker-compose.yml# 6. 添加持久化卷yq-i.services.jeecg-boot-system.volumes [ ./upload:/home/jeecg/upload, ./logs:/home/jeecg/logs ]docker-compose.yml# 7. 验证yqeval.services | keysdocker-compose.yml预期输出redis、jeecg-boot-system、jeecg-vue6. 编译后端与前端6.1 编译后端cd~/JeecgBoot/jeecg-boot# 确保 JDK 17 是默认版本exportJAVA_HOME/usr/lib/jvm/java-17-openjdk-17.0.19.10-7.oe2403sp4.x86_64exportPATH$JAVA_HOME/bin:$PATHjava-version# 编译mvn clean package-Dmaven.test.skiptrue# 验证 jar 包ls-lhjeecg-module-system/jeecg-system-start/target/jeecg-system-start-3.8.3.jar6.2 编译前端cd~/JeecgBoot/jeecgboot-vue3# 安装依赖npminstall--legacy-peer-deps--registryhttps://registry.npmmirror.com# 构建npmrun build# 验证ls-ladist/|head-107. Docker 容器化部署cd~/JeecgBoot# 构建镜像dockercompose build# 启动服务dockercompose up-d# 查看日志dockercompose logs-fjeecg-boot-system启动成功标志日志中出现Application Jeecg-Boot is running! Access URLs: Local: http://localhost:8080/jeecg-boot Swagger文档: http://xxx:8080/jeecg-boot/doc.html8. 登录验证前端地址http://服务器IP默认账号admin默认密码1234569. 踩坑记录全集坑 1Maven 编译报错 无效的目标发行版: 17报错原文[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.14.0:compile (default-compile) on project jeecg-boot-base-core: Fatal error compiling: 无效的目标发行版: 17 - [Help 1]原因系统默认 JDK 版本不是 17。解决方法# 安装 JDK 17dnfinstall-yjava-17-openjdk java-17-openjdk-devel# 切换默认 JDKsudoalternatives--configjava# 选择编号对应的 java-17-openjdk# 切换 javacsudoalternatives--configjavac# 选择编号对应的 java-17-openjdk# 验证java-version# 应显示 openjdk version 17javac-version# 应显示 javac 17坑 2Maven 报错 JAVA_HOME environment variable is not defined correctly报错原文The JAVA_HOME environment variable is not defined correctly This environment variable is needed to run this program NB: JAVA_HOME should point to a JDK not a JRE解决方法# 查找 JDK 17 实际路径whichjavac readlink-f$(whichjavac)# 设置正确的 JAVA_HOMEexportJAVA_HOME/usr/lib/jvm/java-17-openjdk-17.0.19.10-7.oe2403sp4.x86_64exportPATH$JAVA_HOME/bin:$PATH# 写入 .bashrc 永久生效echoexport JAVA_HOME/usr/lib/jvm/java-17-openjdk-17.0.19.10-7.oe2403sp4.x86_64~/.bashrcechoexport PATH\$JAVA_HOME/bin:\$PATH~/.bashrcsource~/.bashrc# 验证mvn-version# 应显示 Java version: 17坑 3npm install 报 stylelint 版本冲突报错原文npm error ERESOLVE unable to resolve dependency tree npm error While resolving: jeecgboot-vue33.8.3 npm error Found: stylelint16.26.1 npm error Could not resolve dependency: npm error peer stylelint 11.x 15 from stylelint-config-prettier9.0.5解决方法# 使用 --legacy-peer-deps 跳过依赖检查npminstall--legacy-peer-deps--registryhttps://registry.npmmirror.com坑 4pnpm install 报 integrity 校验失败报错原文Error: ERR_PNPM_TARBALL_INTEGRITY Failed to verify the integrity of https://registry.npmmirror.com/vue-print-nb-jeecg/-/vue-print-nb-jeecg-1.0.12.tgz Wanted: sha512-zlvD2qFY9wrfH3MYCP91fe1ihVjwNFgycXX6zfC7Q1x6IHAPKvZhke599x86O/Ta4edCxHoYchm72sANuyRw Actual: sha512-jHyWm6/TxB1iU2nHL7upQdHVdxb1SJQ9n3XKeYTaruFdbSphLo1vDtTunS2qVCjupk8lui7FlF5rxxSNr0zjZg原因lockfile 中的哈希值与镜像源实际文件不一致。解决方法# 方法1删除 lockfile 重新生成rm-fpnpm-lock.yamlpnpminstall--registryhttps://registry.npmmirror.com# 方法2跳过 lockfilepnpminstall--no-lockfile--registryhttps://registry.npmmirror.com# 方法3改用 npm最稳妥rm-rfnode_modules package-lock.jsonnpminstall--legacy-peer-deps--registryhttps://registry.npmmirror.com坑 5前端构建报 cross‑env: 未找到命令报错原文sh: 行 1: cross-env: 未找到命令解决方法npminstallcross-env-Dnpmrun build坑 6Docker 镜像拉取超时报错原文Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)解决方法# 配置国内镜像加速mkdir-p/etc/dockercat/etc/docker/daemon.jsonEOF { registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com, https://mirror.baidubce.com ] } EOFsystemctl restartdocker# 再重新拉取dockercompose pulldockercompose up-d坑 7docker‑compose 命令不存在报错原文-bash: docker-compose: 未找到命令原因未安装 Docker Compose 插件。解决方法dnfinstall-ydocker-compose-plugin# 使用 docker compose注意是空格不是横杠dockercompose version坑 8PostgreSQL 容器连接被拒绝报错原文psql: 错误: 连接到服务器IP上的服务器端口5432失败致命错误: 没有用于主机 172.19.0.4, 用户 postgres, 数据库 jeecg_boot, no encryption 的 pg_hba.conf 记录原因pg_hba.conf 未允许 Docker 容器 IP 访问。解决方法echohost all all 172.16.0.0/12 md5/var/lib/pgsql/17/data/pg_hba.conf systemctl restart postgresql17坑 9容器内无法用 127.0.0.1 连接宿主机 PostgreSQL报错原文Caused by: java.net.ConnectException: Connection refused原因容器内的 127.0.0.1 指向容器自身不是宿主机。解决方法使用宿主机真实 IP不是 127.0.0.1SPRING_DATASOURCE_URL: jdbc:postgresql://服务器IP:5432/jeecg_boot坑 10修改 currentSchema 后登录失败报错原文日志中Relation sys_user does not exist原因currentSchemaasset_mgt导致 JeecgBoot 在 asset_mgt Schema 中查找系统表 sys_user但系统表在 public 下。解决方法# 恢复默认数据源不加 currentSchemaSPRING_DATASOURCE_URL: jdbc:postgresql://服务器IP:5432/jeecg_boot# 业务表通过多数据源管理配置# 系统监控 → 数据源管理 → 新增# 数据源地址jdbc:postgresql://服务器IP:5432/jeecg_boot?currentSchemaasset_mgt坑 11多数据源测试连接失败报错原文数据库连接失败Connection to 127.0.0.1:5432 refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.原因数据源地址中使用了 127.0.0.1但 JeecgBoot 容器内 127.0.0.1 指向容器自身。解决方法将 127.0.0.1 改为宿主机真实 IPjdbc:postgresql://服务器IP:5432/jeecg_boot?currentSchemaasset_mgt坑 12AI 功能报认证错误报错原文前端认证错误请检查API密钥或凭据!原因application‑docker.yml 中的 apiKey: ?? 未配置真实密钥。解决方法# 通过环境变量配置推荐yq-i.services.jeecg-boot-system.environment { JEECG_AI_CHAT_APIKEY: 你的真实API密钥, JEECG_AI_CHAT_MODEL: deepseek-chat, JEECG_AI_CHAT_APIHOST: https://api.deepseek.com/v1 }docker-compose.ymldockercompose restart jeecg-boot-system坑 13yq 源码编译失败网络超时报错原文go: download go1.25.0: golang.org/toolchainv0.0.1-go1.25.0.linux-amd64: Get https://proxy.golang.org/...: dial tcp 142.250.69.177:443: i/o timeout解决方法# 方法1使用预编译二进制推荐wget-O/usr/local/bin/yq https://mirror.ghproxy.com/https://github.com/mikefarah/yq/releases/download/v4.44.3/yq_linux_amd64chmodx /usr/local/bin/yq# 方法2如果必须编译配置 Go 代理exportGOPROXYhttps://goproxy.cn,direct go build-oyq坑 14docker compose build 报 target 目录不存在报错原文failed to compute cache key: failed to calculate checksum ... lstat /var/lib/docker/tmp/buildkit-.../target: no such file or directory原因后端 jar 包未编译或路径不对。解决方法# 先编译后端cd~/JeecgBoot/jeecg-boot mvn clean package-Dmaven.test.skiptrue# 确认 jar 包存在ls-lhjeecg-module-system/jeecg-system-start/target/jeecg-system-start-3.8.3.jar# 再重新构建cd~/JeecgBootdockercompose build附录一键环境检查脚本#!/bin/bashecho 环境检查 echoJDK 版本java-version21|head-1echoechoMaven 版本mvn-version21|head-1echoechoNode.js 版本node-vechoechopnpm 版本pnpm-vechoechoDocker 版本docker--versionechoechoDocker Compose 版本dockercompose versionechoechoPostgreSQL 状态systemctl status postgresql17 --no-pager|head-3echoechoyq 版本yq--versionechoecho 检查完成 文档版本v3.0 更新日期2026‑09‑05 作者dboru