如何在IBM BPM中从零开始实现Log4j日志？（入门级指南）

一、准备Log4j依赖包 #

• 下载Log4j 1.x版本的jar包（比如log4j-1.2.17.jar，和你提供的代码兼容）
• 把jar包部署到IBM BPM的共享库：
  • 登录BPM控制台，走「控制台导航栏 > 应用程序 > 企业应用程序」路径
  • 找到你的BPM应用对应的企业应用，进入后选「管理模块 > 模块属性 > 共享库引用」
  • 要么添加已有的共享库（提前把jar包放在共享库指定路径），要么新建共享库并关联jar包，确保应用能加载到Log4j

二、编写Log4j配置文件（xyzlog4j.xml） #

• 按以下示例编写XML配置文件，可按需调整输出方式和格式：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
        </layout>
    </appender>
    <!-- 滚动文件输出 -->
    <appender name="FILE" class="org.apache.log4j.RollingFileAppender">
        <param name="File" value="/opt/ibm/bpm/logs/myapp_bpm.log"/>
        <param name="MaxFileSize" value="10MB"/>
        <param name="MaxBackupIndex" value="5"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
        </layout>
    </appender>
    <!-- 根日志级别 -->
    <root>
        <priority value="INFO"/>
        <appender-ref ref="CONSOLE"/>
        <appender-ref ref="FILE"/>
    </root>
    <!-- 自定义日志分类，要和后续代码里的logger名称对应 -->
    <logger name="myapp.log">
        <level value="INFO"/>
        <appender-ref ref="FILE"/>
    </logger>
</log4j:configuration>

• 把配置文件传到BPM服务器的固定路径，比如/opt/ibm/bpm/config/，记好这个路径后续要用

三、配置BPM环境变量 #

• 打开Process Designer，进入你的应用项目
• 走「环境 > 环境变量」路径，添加两个变量：
  • path：值填配置文件所在的服务器绝对路径，比如/opt/ibm/bpm/config/
  • logpath：值填自定义的日志分类名称，比如myapp.log（必须和配置文件里的<logger name>一致）
• 保存并发布环境变量的变更

四、在流程中嵌入日志代码 #

• 打开需要加日志的流程节点（比如服务脚本、人工任务的前置/后置脚本）
• 插入日志代码，注意和环境变量匹配：

var logMessage = 'Testing logging ';
// 加载Log4j配置
Packages.org.apache.log4j.xml.DOMConfigurator.configure(tw.env.path+"xyzlog4j.xml");
// 获取指定分类的logger实例
var logger = Packages.org.apache.log4j.Logger.getLogger(tw.env.logpath);
// 输出INFO级日志
logger.info(logMessage);

• 按需扩展日志级别，比如logger.debug('调试信息')、logger.error('错误堆栈信息', exception)，但要确保配置文件里开启了对应级别

五、部署验证 #

• 重新部署你的BPM应用到服务器
• 触发流程走到加了日志的节点
• 验证日志：
  • 查看BPM服务器的控制台，确认有日志输出
  • 打开配置文件指定的日志文件（比如/opt/ibm/bpm/logs/myapp_bpm.log），检查是否生成了目标日志内容

关键注意事项 #

• 别混用Log4j 1.x和2.x版本，代码只兼容1.x
• 服务器上的日志文件路径要给BPM应用进程开读写权限，不然写不了日志
• 高频执行的节点别重复调用DOMConfigurator.configure，可以把配置加载逻辑放到应用启动脚本里，减少性能损耗

内容的提问来源于stack exchange，提问作者user183596