从安装到跑通第一个Demo：我的WebLogic 12c/14c避坑实录（Windows环境）-开发者社区

从安装到跑通第一个Demo：我的WebLogic 12c/14c避坑实录（Windows环境）

第一次在企业级项目中接触WebLogic时，那种既兴奋又忐忑的心情至今记忆犹新。作为Oracle旗下的重量级Java EE应用服务器，WebLogic在金融、电信等行业占据着不可替代的地位，但它的安装配置过程却远没有Spring Boot那样的"开箱即用"体验。本文将分享我在Windows环境下从零开始部署WebLogic 12c/14c的全过程，重点解析那些官方文档没有明确提示、却能让新手开发者抓狂的典型问题。

1. 环境准备：那些容易被忽视的前置条件

1.1 JDK版本的选择陷阱

WebLogic对JDK版本的兼容性要求严格到近乎苛刻。我最初随手安装了最新的JDK 17，结果在安装向导刚开始就遭遇了不支持的JDK版本错误。经过查阅文档才发现：

WebLogic 12c (12.1.3) 最高支持JDK 8
WebLogic 14c (14.1.1) 支持JDK 8和JDK 11

推荐组合方案：

WebLogic版本	推荐JDK版本	下载来源
12.1.3	JDK 8u281	Oracle官网或OpenJDK发行版
14.1.1	JDK 11.0.12	AdoptOpenJDK或Amazon Corretto

提示：安装前务必执行java -version确认当前JDK版本，避免因系统存在多个JDK导致的环境混乱。

1.2 安装包的获取与验证

官方下载需要Oracle账户，且流程复杂。我推荐以下两种更便捷的方式：

通过Oracle eDelivery：
- 访问edelivery.oracle.com
- 搜索"WebLogic Server"选择对应版本
- 下载包含fmw_12.1.3.0.0_wls.jar或fmw_14.1.1.0.0_wls.jar的安装包

使用Docker先行体验：

docker pull store/oracle/weblogic:12.2.1.3 docker run -d -p 7001:7001 --name wls12c store/oracle/weblogic:12.2.1.3

安装包下载完成后，务必校验SHA256值，避免因网络传输导致的文件损坏。

2. 安装过程中的"死亡陷阱"

2.1 路径中的隐藏杀手

执行安装命令时：

java -jar fmw_12.1.3.0.0_wls.jar

我遇到了第一个坑——安装路径包含中文。错误提示晦涩难懂：

The installer cannot proceed because the selected Oracle Home contains non-ASCII characters.

解决方案：

使用全英文路径，如C:\Oracle\Middleware
路径中不要有空格（避免使用Program Files）
最好不超过3层目录深度

2.2 安装类型的选择策略

在安装类型选择界面，新手常会困惑于三个选项：

典型安装：包含管理服务器、示例等，适合学习
定制安装：可选择性安装组件，推荐生产环境
精简安装：仅核心功能，适合资源受限环境

我的建议：

开发环境选择典型安装，确保所有组件完整
生产环境务必选择定制安装，移除不需要的示例应用

3. 配置向导中的关键决策点

3.1 节点管理器配置的玄机

配置向导中的节点管理器选项让许多新手困惑。简单来说：

节点管理器相当于WebLogic实例的"看门狗"
开发环境可以跳过（选择"无"）
生产环境建议配置，可实现：
- 自动重启崩溃的服务
- 远程管理多个服务器实例

配置示例：

节点管理器类型：Per Domain 监听地址：localhost 监听端口：5556

3.2 域创建的最佳实践

创建域时，以下几个设置需要特别注意：

域位置：建议与Oracle Home分离，便于后续升级
管理员账户：避免使用默认的weblogic/welcome1
域模式：
- 开发模式：自动部署、快速启动
- 生产模式：严格安全检查

推荐的安全配置：

# 在domain.properties中设置 admin.username=myadmin admin.password=ComplexPwd@123 start.mode=dev

4. 验证与第一个Demo部署

4.1 服务启动的排错指南

启动管理服务器时常见的两个问题：

问题1：端口冲突

Error: Port 7001 is already in use

解决方案：

netstat -ano | findstr 7001 taskkill /PID [占用进程ID] /F

问题2：内存不足

java.lang.OutOfMemoryError: PermGen space

修改startWebLogic.cmd：

set MEM_ARGS=-Xms1024m -Xmx2048m -XX:MaxPermSize=512m

4.2 部署第一个War包的实战

以简单的HelloWorld应用为例：

打包应用：
```
jar -cvf hello.war index.jsp WEB-INF/
```
通过控制台部署：
- 访问http://localhost:7001/console
- 导航至部署→安装
- 选择war文件，选择"作为应用程序安装"
验证访问：
```
curl http://localhost:7001/hello/
```

遇到部署失败时，检查DOMAIN_HOME/servers/AdminServer/logs/AdminServer.log中的错误信息。

5. 性能调优与日常维护

5.1 JVM参数优化配置

生产环境推荐配置（修改setDomainEnv.cmd）：

set MEM_ARGS=-Xms4g -Xmx4g -XX:MetaspaceSize=512m -XX:MaxMetaspaceSize=1g set JAVA_OPTIONS=%JAVA_OPTIONS% -XX:+UseG1GC -XX:MaxGCPauseMillis=200

5.2 日志管理技巧

关键日志文件位置：

域日志：DOMAIN_HOME/servers/AdminServer/logs/AdminServer.log
访问日志：DOMAIN_HOME/servers/AdminServer/logs/access.log
节点管理器日志：DOMAIN_HOME/nodemanager/nodemanager.log

推荐日志轮转配置：

<log-file> <file-name>logs/AdminServer.log</file-name> <rotation-type>byTime</rotation-type> <file-time-span>24</file-time-span> <number-of-files-limited>true</number-of-files-limited> <file-count>10</file-count> </log-file>

6. 开发环境高效工作流

6.1 热部署技巧

传统部署方式需要重启服务，开发效率低下。推荐以下替代方案：

自动部署目录：

mkdir DOMAIN_HOME/autodeploy cp hello.war DOMAIN_HOME/autodeploy/

使用weblogic.Deployer工具：

java weblogic.Deployer -adminurl t3://localhost:7001 -username myadmin -password ComplexPwd@123 -name hello -source hello.war -redeploy

6.2 IDE集成指南

在Eclipse中配置WebLogic服务器：

安装Oracle Enterprise Pack for Eclipse
新建服务器适配器：选择Oracle→WebLogic 12c
配置域目录：指向你的域位置
设置调试端口（默认8453）

IntelliJ IDEA配置更简单：

在Run/Debug Configurations中添加WebLogic Server
指定域路径和启动脚本位置
启用"Update classes and resources on frame deactivation"

7. 生产环境注意事项

7.1 安全加固清单

必须修改的默认配置：

修改控制台端口（非7001）
禁用T3协议匿名访问
启用管理通道（Administration Port）
配置SSL证书

关键安全配置示例：

<security-configuration> <enforce-valid-basic-auth-credentials>true</enforce-valid-basic-auth-credentials> <allow-unencrypted-null-cipher>false</allow-unencrypted-null-cipher> </security-configuration>

7.2 高可用配置要点

典型集群配置步骤：

创建集群：环境→集群→新建
添加托管服务器：至少两个实例

配置会话复制：

<cluster> <multicast-address>239.192.0.1</multicast-address> <multicast-port>7001</multicast-port> <replication-type>async</replication-type> </cluster>

配置负载均衡器（如Apache HTTPD）

8. 监控与性能分析

8.1 关键指标监控

使用WLST脚本获取性能数据：

connect('myadmin','ComplexPwd@123','t3://localhost:7001') serverRuntime() cd('JVMRuntime/AdminServer') heap = cmo.getHeapSizeCurrent() print 'Current heap: '+str(heap/1024/1024)+'MB'

推荐监控指标：

JVM堆内存使用率
活动会话数
JDBC连接池等待数
执行队列待处理请求

8.2 线程转储分析

获取线程转储：

jps -l # 获取WebLogic进程ID jstack -l <pid> > thread_dump.txt

分析工具推荐：

TDA（Thread Dump Analyzer）
VisualVM（带线程分析插件）
Eclipse Memory Analyzer（MAT）

9. 常见问题速查手册

9.1 启动类问题

症状：服务启动后立即退出
检查：

查看DOMAIN_HOME/servers/AdminServer/logs/AdminServer.out
确认JDK版本兼容性
检查config.xml是否有语法错误

9.2 部署失败排查

典型错误：weblogic.application.ModuleException
排查步骤：

检查war包完整性：jar -tvf hello.war
查看应用特定日志：DOMAIN_HOME/servers/AdminServer/logs/hello.log

验证weblogic.xml配置：

<container-descriptor> <prefer-web-inf-classes>true</prefer-web-inf-classes> </container-descriptor>

10. 进阶资源推荐

10.1 官方文档精要

必读文档：

《WebLogic Server Administration Console Online Help》
《Developing Applications for Oracle WebLogic Server》
《Performance and Tuning for Oracle WebLogic Server》

快速访问方式：

# 本地文档（安装后可用） start chrome http://localhost:7001/console-help

10.2 社区资源

优质技术博客：

Oracle WebLogic Team Blog
Middleware Magic
WebLogic Tips & Tricks

实用工具集合：

WLST Script Generator：自动化管理脚本生成
WebLogic Maven Plugin：集成部署到构建流程
Jenkins WebLogic Deploy Plugin：CI/CD集成

在最近的一个金融项目中，我们团队花了三天时间才解决了一个诡异的类加载问题——根本原因是WebLogic和应用的SLF4J版本冲突。这个经历让我深刻体会到，掌握WebLogic的类加载机制（特别是APP-INF/lib和LIB-INF/lib的区别）和学会分析PreferWebInfClasses参数的重要性。

从安装到跑通第一个Demo：我的WebLogic 12c/14c避坑实录（Windows环境）