简介这份源码包面向需要在Linux环境下搭建泛微OAecology9系统的运维与实施人员提供从数据库安装、应用部署、数据库初始化到系统运行四个阶段的完整参考流程。资源共3个文件以inscode工程配置、html页面和gitignore忽略规则为主压缩包约5KB体量轻便适合作为部署脚本与配置模板的起点。内容涉及root权限执行安装脚本、libaio依赖检查、安装目录选择、程序文件上传与安装脚本执行、浏览器端数据库创建与配置以及验证码、附件上传、授权管理、防火墙与内存分配等关键细节可帮助读者快速理解各环节的先后顺序与注意事项。目前已有505人学习适合具备Linux基础、希望减少部署试错成本的开发者对照实践。1. 泛微OA源码在Linux上部署从环境准备到跑通登录页手里拿到一个泛微OA的源码包要在Linux服务器上把它跑起来这件事听起来像是“把文件传上去、装个数据库、改改配置”就完事但真正动过手的人都知道坑往往藏在JDK版本、数据库字符集、中间件端口冲突和License授权这几处。泛微OAe-cology或e-office系列本质是一套Java Web应用依赖JDK、Tomcat或Resin、MySQL/SQL Server/Oracle以及一堆配置文件源码部署意味着你要自己编译或至少自己组装运行环境而不是用官方一键安装包。这篇文章面向的是拿到源码后需要在Linux上独立完成部署的运维和开发人员尤其是国产Linux麒麟、统信UOS或CentOS/Ubuntu环境下的实操场景。我会按“环境准备→数据库初始化→中间件配置→应用部署→验证排错”的顺序把每一步的命令、参数和踩坑点讲清楚让你能照着复现而不是对着报错日志发呆。2. 部署前的环境选型与依赖清单2.1 JDK版本怎么选别用最新版泛微OA的源码包通常对JDK版本有硬性要求。e-cology 9.0/10.0系列大多基于JDK 8编译部分新版本开始支持JDK 11但如果你拿到的是较老的源码包直接上JDK 17或21大概率会在启动时遇到UnsupportedClassVersionError或者反射相关的InaccessibleObjectException。我一般会先看源码包里WEB-INF/lib下有没有rt.jar依赖或者看pom.xml里的maven.compiler.source以此判断目标JDK版本。# 查看源码包中编译版本线索 cd /opt/weaver-source find . -name pom.xml -exec grep -H maven.compiler {} \; # 或者直接看class文件版本52对应JDK855对应JDK11 javap -verbose -cp WEB-INF/classes com.weaver.Startup 2/dev/null | grep major version逻辑说明major version52代表JDK 855代表JDK 11。如果源码包里class文件是52你装JDK 11也能跑但装JDK 17就可能出问题。参数上建议用update-alternatives管理多版本JDK避免全局环境变量被改乱。# 安装JDK 8以CentOS为例 yum install -y java-1.8.0-openjdk-devel # 确认版本 java -version # 如果系统里有多个JDK用alternatives切换 alternatives --config java提示国产Linux上如果yum源里没有openjdk可以用apt或从镜像站下载tar.gz手动解压设置JAVA_HOME即可不必强求包管理器。2.2 数据库选型与字符集设置泛微OA源码默认支持MySQL 5.7/8.0、SQL Server和Oracle。中小规模部署我优先选MySQL 8.0但要注意MySQL 8.0默认字符集是utf8mb4而泛微的部分老表结构用的是utf8即utf8mb3混用可能导致建表失败或乱码。更稳妥的做法是在my.cnf里显式指定服务端字符集。# /etc/my.cnf 关键配置 [mysqld] character-set-serverutf8mb4 collation-serverutf8mb4_general_ci default-authentication-pluginmysql_native_password max_connections500 innodb_buffer_pool_size2G参数说明default-authentication-plugin必须设为mysql_native_password因为泛微的JDBC驱动尤其是老版本不支持MySQL 8.0默认的caching_sha2_password否则会报Unable to load authentication plugin。max_connections根据并发用户数调整500起步。innodb_buffer_pool_size建议设为物理内存的50%~60%。-- 创建数据库和用户 CREATE DATABASE ecology DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER ecology% IDENTIFIED WITH mysql_native_password BY YourStrongPass123; GRANT ALL PRIVILEGES ON ecology.* TO ecology%; FLUSH PRIVILEGES;逻辑说明数据库名ecology是泛微e-cology的默认库名e-office则常用eoffice。用户权限给ALL是为了避免初始化时因权限不足中断生产环境可以在初始化完成后收回部分权限。2.3 中间件选择Tomcat还是Resin泛微官方推荐Resin但源码部署场景下Tomcat更通用、资料更多。Tomcat 8.5/9.0都可以关键是server.xml里的端口和context.xml里的数据源配置。如果你用Tomcat 10注意包名从javax.*变成了jakarta.*泛微源码里大量javax.servlet引用会直接编译失败所以别踩这个坑。# 下载Tomcat 9示例实际用镜像站 wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.80/bin/apache-tomcat-9.0.80.tar.gz tar -zxvf apache-tomcat-9.0.80.tar.gz -C /opt/ mv /opt/apache-tomcat-9.0.80 /opt/tomcat注意Tomcat 9.0.80之后的版本对URIEncoding默认已是UTF-8但泛微的部分老代码依赖ISO-8859-1解码如果遇到中文参数乱码需要在server.xml的Connector里显式加URIEncodingUTF-8。3. 源码编译与数据库初始化实操3.1 用Maven编译源码包拿到源码后先确认项目结构。泛微的源码包通常是一个多模块Maven项目根目录下有pom.xml子模块包括weaver-core、weaver-web等。编译前要检查settings.xml里的私服地址是否还能访问很多老项目的私服已经下线需要手动替换依赖。# 进入源码根目录 cd /opt/weaver-source # 跳过测试编译指定JDK 8 export JAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk mvn clean package -DskipTests -P prod逻辑说明-DskipTests跳过单元测试因为泛微的测试用例往往依赖外部数据库和License本地跑必挂。-P prod激活生产环境Profile如果源码里没有定义Profile去掉这个参数。编译成功后war包通常在weaver-web/target/下。# 查看编译产物 ls -lh weaver-web/target/*.war # 复制到Tomcat webapps cp weaver-web/target/ecology.war /opt/tomcat/webapps/参数说明war包名决定了访问路径如果叫ecology.war访问地址就是http://IP:8080/ecology。如果你想部署为ROOT把war包改名为ROOT.war但泛微的很多静态资源路径是写死的/ecology/改ROOT反而会404所以别动。3.2 数据库脚本导入的两种方式泛微源码包里一般会带dbscript或sql目录里面有建表脚本和初始数据。导入方式有两种用MySQL命令行直接source或者用Navicat等工具。Linux上我推荐命令行因为可以精确控制字符集。# 导入建表脚本 mysql -u ecology -pYourStrongPass123 --default-character-setutf8mb4 ecology /opt/weaver-source/dbscript/mysql/create.sql # 导入初始数据 mysql -u ecology -pYourStrongPass123 --default-character-setutf8mb4 ecology /opt/weaver-source/dbscript/mysql/initdata.sql逻辑说明--default-character-setutf8mb4必须加否则客户端连接字符集不对导入的中文会变问号。如果脚本里有DELIMITER语句命令行source可能报错这时改用source命令在MySQL交互模式下执行。-- 在MySQL交互模式下 USE ecology; SOURCE /opt/weaver-source/dbscript/mysql/create.sql; SOURCE /opt/weaver-source/dbscript/mysql/initdata.sql;提示导入完成后检查SELECT COUNT(*) FROM HrmResource;是否有数据如果为0说明初始数据没进去后面登录会提示用户不存在。3.3 配置文件的关键参数修改泛微OA的配置文件集中在WEB-INF/prop/目录下核心是weaver.properties和init.properties。数据库连接、License、文件上传路径都在这里改。# weaver.properties 关键项 ecology.urljdbc:mysql://127.0.0.1:3306/ecology?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai ecology.usernameecology ecology.passwordYourStrongPass123 ecology.drivercom.mysql.cj.jdbc.Driver # 文件存储路径确保Linux下有写权限 ecology.filePath/data/weaver/files ecology.logPath/data/weaver/logs参数说明serverTimezoneAsia/Shanghai不加会报时区错误。ecology.filePath必须提前创建并授权给Tomcat运行用户否则上传附件时会报Permission denied。mkdir -p /data/weaver/files /data/weaver/logs chown -R tomcat:tomcat /data/weaver chmod -R 755 /data/weaver逻辑说明Tomcat以哪个用户运行目录就授权给谁。如果是用systemd管理Tomcat用户通常是tomcat如果是手动startup.sh启动用户就是你当前登录用户。4. 启动验证与常见故障排查4.1 启动Tomcat并观察日志部署完成后启动Tomcat不要急着打开浏览器先看日志。# 启动Tomcat /opt/tomcat/bin/startup.sh # 实时查看catalina.out tail -f /opt/tomcat/logs/catalina.out逻辑说明泛微启动时会初始化Spring容器、加载License、连接数据库任何一步失败都会在日志里留下堆栈。看到Server startup in xxx ms才算启动成功。如果卡在Initializing Spring root WebApplicationContext多半是数据库连不上或License无效。# 检查端口监听 ss -tlnp | grep 8080 # 检查数据库连接 mysql -u ecology -pYourStrongPass123 -e SELECT 1;4.2 登录页能打开但登录报错的排查这是最常见的“假成功”场景浏览器能打开登录页但输入账号密码后提示“用户名或密码错误”或“系统未授权”。前者多半是初始数据没导入或密码加密方式不对后者是License问题。-- 检查用户表 SELECT id, loginid, password FROM HrmResource WHERE loginidsysadmin; -- 泛微默认管理员账号是sysadmin密码通常是加密存储的如果HrmResource表为空重新导入initdata.sql。如果表里有数据但登录失败检查weaver.properties里的ecology.license路径是否指向有效的License文件。泛微的License和服务器MAC地址、IP绑定换机器后必须重新申请。注意源码部署场景下License文件通常需要向泛微官方或代理商获取没有License只能进入演示模式部分版本限制20用户。4.3 中文乱码的三个检查点中文乱码在国产Linux上尤其常见因为系统默认locale可能是zh_CN.GBK或POSIX。检查三个地方数据库字符集、Tomcat Connector的URIEncoding、JVM的file.encoding。# 检查系统locale locale # 如果输出不是UTF-8临时设置 export LANGzh_CN.UTF-8 export LC_ALLzh_CN.UTF-8!-- server.xml Connector加URIEncoding -- Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 URIEncodingUTF-8 useBodyEncodingForURItrue /# catalina.sh里加JVM参数 JAVA_OPTS$JAVA_OPTS -Dfile.encodingUTF-8 -Dsun.jnu.encodingUTF-8逻辑说明file.encoding影响Java读取文件时的默认编码sun.jnu.encoding影响文件名编码。两个都设UTF-8能解决大部分乱码。如果还有问题检查MySQL的character_set_server和collation_server。5. 避坑清单源码部署泛微OA的5个血泪教训5.1 坑一JDK版本不匹配导致启动即崩现象Tomcat启动后catalina.out里出现java.lang.UnsupportedClassVersionError: com/weaver/... has been compiled by a more recent version of the Java Runtime。原因源码编译时用的JDK版本高于运行环境JDK。比如编译用JDK 11运行用JDK 8class文件版本55 52JVM拒绝加载。解决统一编译和运行JDK版本。如果源码是别人编译好的war包用javap -verbose看class版本然后装对应JDK。别想着用高版本JDK跑低版本class反过来可以正过来不行。5.2 坑二MySQL 8.0认证插件导致连接失败现象启动日志报Unable to load authentication plugin caching_sha2_password。原因MySQL 8.0默认用caching_sha2_password而泛微源码里捆绑的JDBC驱动是5.1.x版本不支持这个插件。解决要么改用户认证插件为mysql_native_password要么升级JDBC驱动到8.0.x。改插件更快ALTER USER ecology% IDENTIFIED WITH mysql_native_password BY YourStrongPass123; FLUSH PRIVILEGES;5.3 坑三文件上传目录权限不足现象登录后上传附件页面提示“上传失败”日志里java.io.FileNotFoundException: /data/weaver/files/... (Permission denied)。原因Tomcat运行用户对ecology.filePath目录没有写权限。解决chown -R tomcat:tomcat /data/weaver chmod -R 755 /data/weaver。如果SELinux开启还需要chcon -R -t tomcat_var_lib_t /data/weaver或直接setenforce 0临时关闭生产环境建议配策略而非关闭。5.4 坑四License绑定MAC地址换机即失效现象从测试机迁移到生产机后登录提示“系统未授权”或“License无效”。原因泛微License文件里绑定了服务器的MAC地址或IP换机器后不匹配。解决联系泛微重新生成License或者用ifconfig查看新机器MAC如果和旧机器一致比如虚拟机克隆可以改MAC地址。但这不是长久之计正规做法是走授权流程。5.5 坑五Tomcat 10的jakarta包名不兼容现象用Tomcat 10部署启动报java.lang.NoClassDefFoundError: javax/servlet/Servlet。原因Tomcat 10实现了Servlet 5.0规范包名从javax.servlet改为jakarta.servlet而泛微源码里全是javax.servlet引用。解决换Tomcat 9或8.5。别试图用迁移工具改包名泛微的依赖树太深改不干净。6. 进阶技巧用systemd托管Tomcat并做开机自启手动startup.sh启动Tomcat有个问题SSH会话断开后进程可能被挂断而且服务器重启后不会自动拉起。生产环境我习惯用systemd托管顺便把日志和JVM参数固化下来。# /etc/systemd/system/tomcat.service [Unit] DescriptionApache Tomcat for Weaver OA Afternetwork.target mysqld.service [Service] Typeforking Usertomcat Grouptomcat EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk EnvironmentCATALINA_HOME/opt/tomcat EnvironmentCATALINA_BASE/opt/tomcat EnvironmentJAVA_OPTS-Xms2g -Xmx4g -Dfile.encodingUTF-8 -Dsun.jnu.encodingUTF-8 ExecStart/opt/tomcat/bin/startup.sh ExecStop/opt/tomcat/bin/shutdown.sh Restarton-failure RestartSec10 [Install] WantedBymulti-user.target参数说明Typeforking因为startup.sh会fork子进程。Restarton-failure让Tomcat崩溃后10秒自动重启这对OA这种不能随便停的系统很实用。JAVA_OPTS里-Xms2g -Xmx4g根据服务器内存调整泛微OA用户数多的话堆内存别低于4G。# 重载systemd并设置开机自启 systemctl daemon-reload systemctl enable tomcat systemctl start tomcat # 查看状态 systemctl status tomcat逻辑说明Afternetwork.target mysqld.service确保网络和数据库先启动避免Tomcat先起来连不上库。Usertomcat要求/opt/tomcat和/data/weaver的属主都是tomcat否则权限报错。验证方法systemctl stop tomcat再systemctl start tomcat观察catalina.out是否正常输出启动日志。然后reboot服务器看Tomcat是否自动拉起。如果没起来journalctl -u tomcat -f看systemd层面的报错。我自己的习惯是每次改完配置先systemctl restart tomcat然后tail -f catalina.out盯30秒确认没有SEVERE级别的日志才去干别的。这个习惯帮我省了很多“半夜被叫起来重启服务”的后悔药。希望帮到你。本文还有配套的精品资源点击获取
