CentOS 8 安装 Apache Commons SCXML 指南

在 CentOS 8 上从零安装 Apache Commons SCXML 0.9（2008 年最终版），覆盖 EOL 源修复（vault 403 归档镜像切换）、dnf 安装 OpenJDK 8 与 Maven 3.5.4、optional 依赖补齐、官方 bin 包与 jar 直跑两种方案，命令回显均实测通过。

Apache Commons SCXMLApache Commons SCXML2026/10/15

CentOS 8 安装 Apache Commons SCXML 指南

目标：在 CentOS 8 上从零搭建 Apache Commons SCXML 0.9 的开发与运行环境（OpenJDK 8 + Maven 3.5.4），跑通「模型解析 → 状态机驱动 → 事件流转」的最小验证程序，并给出官方 bin 包 + jar 直跑的离线方案；本文全部命令与回显均已在 CentOS 8 实测通过，其中软件源已按 EOL 后归档镜像方式修复。

Apache Commons SCXML 是 Apache Commons 项目下的状态机引擎，实现了 W3C 的状态图 XML（State Chart XML）标准：状态、事件、转移条件写成一份 .scxml 模型文件，Java 侧用 SCXMLExecutor 加载并驱动。它是纯 Java 库，没有常驻服务，「安装完成」的判定标准是能解析模型并跑通一次状态流转。CentOS 8 于 2021 年底停止维护，其官方源已下线，本文第一手工作就是把软件源切到可用的归档镜像，再走标准安装流程。

一、环境信息

本节固定可复现的基线环境。需要特别说明：CentOS 8 的最后一个版本线是 8.4.2105（8.5.2111 仅存在于归档仓库，未发完整发行版），本文以 8.4.2105 为基线。

  • 操作系统：CentOS Linux release 8.4.2105
  • 架构：x86_64
  • JDK：OpenJDK 1.8.0_312（dnf 包 java-1.8.0-openjdk-devel）
  • 构建工具：Apache Maven 3.5.4（dnf 包 maven）
  • 组件版本：commons-scxml 0.9（2008-11-22 发布，0.x 系列最终版本）
  • 官方下载目录：https://downloads.apache.org/commons/scxml/
  • Maven 坐标：commons-scxml:commons-scxml:0.9
  • 验证用工作目录：/opt/scxml-demo/scxml-demo（Maven 工程）、/opt/scxml-demo/jar-run（jar 直跑）

系统与架构确认（实时回显）：

cat /etc/centos-release

CentOS Linux release 8.4.2105

uname -m

x86_64

💡 说明：Commons SCXML 是库而非服务，环境中没有需要常驻的守护进程；验证标准是解析一份 .scxml 模型并驱动状态流转成功，而不是某个端口处于监听状态。

二、前置条件

  1. 具有 root 或 sudo 权限的 CentOS 8 系统。
  2. 可访问阿里云归档镜像 mirrors.aliyun.com（8.4.2105 的历史包全部存于该镜像的 centos-vault 目录）。
  3. 可访问 Apache 官方下载站 downloads.apache.org 与 Maven 中央仓库 repo1.maven.org。
  4. 至少 2 GB 可用磁盘空间。

必须先修复 EOL 软件源。 CentOS 8 官方源域名 mirror.centos.org 已下线，原始配置指向 vault.centos.org 的归档仓库实测也被拒绝访问（403 Forbidden，实时回显）：

curl -sI --max-time 15 https://vault.centos.org/8.4.2105/os/x86_64/os/repodata/repomd.xml | head -1

HTTP/2 403

阿里云的 centos-vault 归档目录则完整可用（实时回显）：

curl -sI --max-time 15 https://mirrors.aliyun.com/centos-vault/8.4.2105/BaseOS/x86_64/os/repodata/repomd.xml | head -2

HTTP/2 200
content-type: text/xml

执行源切换：注释掉所有 mirrorlist 行，把被注释的 #baseurl=http://mirror.centos.org/$contentdir 改写为指向阿里云归档的 baseurl（实时回显）：

sed -i -e 's|mirrorlist=|#mirrorlist=|g' -e 's|#baseurl=http://mirror.centos.org/$contentdir|baseurl=https://mirrors.aliyun.com/centos-vault|g' /etc/yum.repos.d/CentOS-*.repo
grep -A1 '^baseurl' /etc/yum.repos.d/CentOS-Linux-BaseOS.repo

baseurl = https://mirrors.aliyun.com/centos-vault/8/BaseOS/$basearch/os/

注意改写后的 URL 版本段是 centos-vault/8：dnf 的 $releasever 默认取 8，而归档仓库按完整版本号（如 8.4.2105）分目录，直接访问会 404。固定 $releasever 为 8.4.2105 并重建缓存（实时回显）：

echo '8.4.2105' > /etc/dnf/vars/releasever && dnf makecache 2>&1 | tail -3

# 输出节选（实测首尾）
CentOS-8 - AppStream
CentOS-8 - Base
Metadata Cache Created.

验证点：Metadata Cache Created. 表示归档源可用，后续安装命令不再报仓库 404。

三、版本选型说明

第一，官方在维护的最新发布版就是 0.9。 官方下载目录当前只保留 0.9 一代（实时回显）：

curl -s https://downloads.apache.org/commons/scxml/ | grep -oE 'v[0-9.]+</h1>'

v0.9</h1>

发布时间可从发布说明的版本控制标识确认——$Id 行标注了 2008-11-22（实时回显）：

curl -s https://downloads.apache.org/commons/scxml/RELEASE-NOTES.txt | grep 'Id:'

$Id: RELEASE-NOTES.txt 719758 2008-11-22 00:10:31Z rahul $

第二，维护状态是「休眠（Dormant）」。 Apache Commons 官网已把 SCXML 列入 Dormant 项目名单：0.9 之后 18 年再无新版本，不再接收功能开发与安全补丁。选型含义：API 完全冻结，回归风险为零；但要清楚它的交付形态停留在 2010 年前后——optional 依赖要手工补齐、bin 包不捆绑依赖 jar（见第四、五节），把它当作「标准 SCXML 模型文件的稳定解释器」来用最合适。

Maven 中央仓库的全谱系版本（实时回显）：

curl -s https://repo1.maven.org/maven2/commons-scxml/commons-scxml/maven-metadata.xml | grep -E 'latest|release|version>'

    <latest>0.9</latest>
    <release>0.9</release>
      <version>0.5</version>
      <version>0.6</version>
      <version>0.7</version>
      <version>0.8</version>
      <version>0.9</version>
版本线最新版发布时间Maven 坐标适用场景
0.5–0.8（历史）0.82007 年及更早commons-scxml:commons-scxml:0.8仅维护遗留系统时接触
0.9（最终版）0.92008-11-22commons-scxml:commons-scxml:0.9本专栏全部示例所用；0.x 系列功能最全、修复最多的一版

第三，坐标必须写 commons-scxml 这个老 groupId。 该组件发布早于 Commons 统一迁移到 org.apache.commons 的时代，中央仓库里 org.apache.commons:commons-scxml 不存在（实时回显为 404）：

curl -sI https://repo1.maven.org/maven2/org/apache/commons/commons-scxml/maven-metadata.xml | head -1

HTTP/2 404

JDK 兼容性实测结论： 0.9 的字节码为 Java 1.4 版本（major 48），本文实测 OpenJDK 1.8.0_312 上编译运行一切正常，作者同时在 Temurin 17.0.20.1 上验证过同一套示例（解析、事件流转、上下文、监听器、延时事件均可），JDK 17 路线的注意事项见 FAQ Q3。CentOS 8.4.2105 归档源实测没有 JDK 17 包（FAQ Q2），本文按 OpenJDK 8 撰写，与 0.9 同代、归档源可用，是最务实的选择。

💡 技术拓展：Java 生态里的状态机引擎定位差异很大——

方案模型载体特点适用场景
Commons SCXMLW3C SCXML 标准 XML 文件模型与代码彻底分离，模型可热更、可跨语言复用对模型标准化/可审计有要求的场景
Spring StatemachineJava DSL + 配置类与 Spring 生态深度整合，有持久化/监控扩展Spring 技术栈的新项目
Squirrel FoundationJava 注解/构建器轻量高性能，函数式风格嵌入式、性能敏感的纯 Java 场景
Stateless4jJava 流式 DSL极简 API，单 jar小型状态流转逻辑

本文采用 Commons SCXML 0.9，理由是模型为 W3C 标准 XML 文件，设计成果不绑定 Java 代码，且引擎自带免编译的交互式验证工具（5.5 节）。

四、方案 A：Maven 依赖安装（在线，推荐）

4.1 方案说明

方案 A 的链路是：dnf 安装 java-1.8.0-openjdk-devel 与 maven → pom 声明 commons-scxml:commons-scxml:0.9 → Maven 解析传递依赖 → 编译运行验证程序。有一个 0.9 特有的前置认知必须先交代：它的 POM 把两个运行期真正需要的依赖声明成了 optional（可选依赖不随 Maven 传递），工程里必须显式补上，否则分别栽在「表达式无法求值」和「解析器缺类」两个坑上，细节见 4.3 节与 FAQ Q4。

4.2 安装 OpenJDK 8 与 Maven

dnf install -y java-1.8.0-openjdk-devel maven

# 输出节选（实测首尾）
Installed:
  java-1.8.0-openjdk-devel-1:1.8.0.312.b07-1.el8_4.x86_64                          maven-1:3.5.4-5.module_el8.0.0+39+6a9b6e22.noarch
（中间为 java-1.8.0-openjdk 运行时、maven 模块等依赖包安装明细）
Complete!

确认包版本与 JVM 目录（实时回显）：

rpm -q java-1.8.0-openjdk-devel maven

java-1.8.0-openjdk-devel-1:1.8.0.312.b07-1.el8_4.x86_64
maven-1:3.5.4-5.module_el8.0.0+39+6a9b6e22.noarch

java -version

openjdk version "1.8.0_312"
OpenJDK Runtime Environment (build 1.8.0_312-b07)
OpenJDK 64-Bit Server VM (build 25.312-b07, mixed mode)

确认 Maven 可定位 JDK（实时回显，实测不导出 JAVA_HOME 时 Maven 也能通过 PATH 找到唯一安装的 JDK 8）：

mvn -version

Apache Maven 3.5.4 (Red Hat 3.5.4-5)
Maven home: /usr/share/maven
Java version: 1.8.0_312, vendor: Oracle Corporation, runtime: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.312.b07-1.el8_4.x86_64/jre

⚠️ 注意：Java version 依赖 PATH 里的 java。一旦机器上再装其他 JDK（如从归档源装 11 或 17），Maven 可能选错运行时，届时必须显式 export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk（这是指向实际目录的软链接，稳定可用），建议直接写入 /etc/profile.d/ 脚本固化。

4.3 创建工程并引入依赖

mkdir -p /opt/scxml-demo/scxml-demo/src/main/java/demo /opt/scxml-demo/scxml-demo/models

pom.xml（完整内容，文件路径 /opt/scxml-demo/scxml-demo/pom.xml）：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>demo</groupId>
  <artifactId>scxml-demo</artifactId>
  <version>1.0.0</version>
  <packaging>jar</packaging>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>commons-scxml</groupId>
      <artifactId>commons-scxml</artifactId>
      <version>0.9</version>
    </dependency>
    <dependency>
      <groupId>commons-jexl</groupId>
      <artifactId>commons-jexl</artifactId>
      <version>1.1</version>
    </dependency>
    <dependency>
      <groupId>xalan</groupId>
      <artifactId>xalan</artifactId>
      <version>2.7.2</version>
    </dependency>
  </dependencies>
</project>

逐项说明关键配置：

  • commons-scxml:commons-scxml:0.9：引擎本体。Maven 自动带入三个 compile 传递依赖：commons-logging:1.1.1、commons-digester:1.8、commons-beanutils:1.7.0（4.6 节依赖树可证）。
  • commons-jexl:commons-jexl:1.1：必须显式声明。 0.9 的 POM 把 JEXL 表达式引擎标为 optional，不声明则模型里的 cond、expr 表达式全部无法求值。
  • xalan:xalan:2.7.2：必须显式声明。 模型解析器用到 Xalan 的 org.apache.xml.utils.PrefixResolver 类，0.9 的 POM 把它标为 optional，不声明则解析任何模型都抛 NoClassDefFoundError（完整报错与解法见 FAQ Q4）。
  • maven.compiler.source/target=8：CentOS 8 的 Maven 3.5.4 自带的编译插件默认值偏低，显式钉住 8 避免老插件对 source/target 的自动推断。

4.4 编写状态机模型

验证模型是一台红绿灯：red、green、yellow 三个状态靠 timer 事件循环流转。模型文件是纯 XML，与 Java 代码完全分离（文件路径 /opt/scxml-demo/scxml-demo/models/traffic-light.scxml）：

<?xml version="1.0" encoding="UTF-8"?>
<scxml xmlns="http://www.w3.org/2005/07/scxml" version="1.0" initial="red">

  <state id="red">
    <transition event="timer" target="green"/>
  </state>

  <state id="green">
    <transition event="timer" target="yellow"/>
  </state>

  <state id="yellow">
    <transition event="timer" target="red"/>
  </state>

</scxml>

逐项说明：

  • 根元素 <scxml> 的 xmlns 固定为 W3C SCXML 命名空间 http://www.w3.org/2005/07/scxml，解析器按该命名空间识别元素。
  • initial="red" 指定初始状态，go() 时引擎自动进入。
  • <transition event="timer" target="green"/> 表示「在当前状态收到 timer 事件则迁移到 green」。

4.5 最小验证代码

验证程序 TrafficLightDemo.java（文件路径 /opt/scxml-demo/scxml-demo/src/main/java/demo/TrafficLightDemo.java）覆盖「解析模型 → 构建执行器 → 驱动初始态 → 连发三次事件」完整链路：

package demo;

import java.net.URL;
import java.util.Set;
import org.apache.commons.scxml.SCXMLExecutor;
import org.apache.commons.scxml.TriggerEvent;
import org.apache.commons.scxml.env.SimpleErrorHandler;
import org.apache.commons.scxml.env.SimpleErrorReporter;
import org.apache.commons.scxml.env.jexl.JexlEvaluator;
import org.apache.commons.scxml.io.SCXMLParser;
import org.apache.commons.scxml.model.SCXML;
import org.apache.commons.scxml.model.TransitionTarget;

public class TrafficLightDemo {
    public static void main(String[] args) throws Exception {
        URL model = new java.io.File(args[0]).toURI().toURL();
        SCXML scxml = SCXMLParser.parse(model, new SimpleErrorHandler());
        System.out.println("模型解析成功, 根状态个数=" + scxml.getChildren().size());

        SCXMLExecutor exec = new SCXMLExecutor(new JexlEvaluator(), null, new SimpleErrorReporter());
        exec.setStateMachine(scxml);
        exec.go();
        printStates("初始配置", exec);

        exec.triggerEvent(new TriggerEvent("timer", TriggerEvent.SIGNAL_EVENT));
        printStates("发出第 1 个 timer 后", exec);

        exec.triggerEvent(new TriggerEvent("timer", TriggerEvent.SIGNAL_EVENT));
        printStates("发出第 2 个 timer 后", exec);

        exec.triggerEvent(new TriggerEvent("timer", TriggerEvent.SIGNAL_EVENT));
        printStates("发出第 3 个 timer 后", exec);
    }

    static void printStates(String tag, SCXMLExecutor exec) {
        Set<TransitionTarget> states = exec.getCurrentStatus().getStates();
        for (TransitionTarget t : states) {
            System.out.println(tag + " -> " + t.getId());
        }
    }
}

核心五步：SCXMLParser.parse() 把 XML 解析成 SCXML 模型对象；new SCXMLExecutor(evaluator, null, errorReporter) 组装执行器，表达式引擎选 JexlEvaluator；setStateMachine() 挂载模型；go() 驱动引擎进入初始状态；triggerEvent() 派发事件并立即完成转移。

4.6 编译与运行验证

cd /opt/scxml-demo/scxml-demo && mvn -B clean compile 2>&1 | tail -3

[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.612 s
[INFO] Finished at: 2026-10-15T10:18:12+08:00
[INFO] ------------------------------------------------------------------------

确认依赖树中三组依赖各就各位（输出节选，实测）：

mvn -B dependency:tree 2>&1 | grep -E ':tree|\\\\-|\\+-'

[INFO] --- maven-dependency-plugin:2.8:tree (default-cli) @ scxml-demo ---
[INFO] +- commons-scxml:commons-scxml:jar:0.9:compile
[INFO] |  +- commons-logging:commons-logging:jar:1.1.1:compile
[INFO] |  +- commons-digester:commons-digester:1.8:compile
[INFO] |  \- commons-beanutils:commons-beanutils:jar:1.7.0:compile
[INFO] +- commons-jexl:commons-jexl:jar:1.1:compile
[INFO] |  \- junit:junit:jar:3.8.1:compile
[INFO] \- xalan:xalan:jar:2.7.2:compile
[INFO]    \- xalan:serializer:jar:2.7.2:compile
[INFO]       \- xml-apis:xml-apis:jar:1.3.04:compile

依赖树证明了 4.3 节的两个论断：commons-logging、commons-digester、commons-beanutils 自动传递，而 commons-jexl 与 xalan 因 optional 声明必须手工补齐。

编译产物的 classpath 需要把六个 jar 全部拼上，运行验证程序：

R=~/.m2/repository
CP=target/classes:$R/commons-scxml/commons-scxml/0.9/commons-scxml-0.9.jar:$R/commons-logging/commons-logging/1.1.1/commons-logging-1.1.1.jar:$R/commons-digester/commons-digester/1.8/commons-digester-1.8.jar:$R/commons-beanutils/commons-beanutils/1.7.0/commons-beanutils-1.7.0.jar:$R/commons-jexl/commons-jexl/1.1/commons-jexl-1.1.jar:$R/xalan/xalan/2.7.2/xalan-2.7.2.jar
java -Dfile.encoding=UTF-8 -cp $CP demo.TrafficLightDemo /opt/scxml-demo/scxml-demo/models/traffic-light.scxml

模型解析成功, 根状态个数=3
初始配置 -> red
发出第 1 个 timer 后 -> green
发出第 2 个 timer 后 -> yellow
发出第 3 个 timer 后 -> red

结果解读：初始配置为 red（与模型 initial 属性一致）；三次 timer 事件使状态沿 red → green → yellow → red 循环一周回到起点，转移逻辑与模型声明完全吻合。至此 commons-scxml 0.9 在本机完整可用。

验证点汇总：

检查项预期（实测值）不符时排查
dnf makecacheMetadata Cache Created.404 → 检查 /etc/dnf/vars/releasever 是否为 8.4.2105
mvn clean compileBUILD SUCCESS报缺类 → FAQ Q4；插件报错 → FAQ Q5
运行首行模型解析成功, 根状态个数=3NoClassDefFoundError: PrefixResolver → FAQ Q4
运行末行发出第 3 个 timer 后 -> red中文乱码 → FAQ Q6

五、方案 B：官方 bin 包 + jar 直跑（离线友好）

5.1 方案说明

链路是：下载官方 bin 包 → 校验 sha256 → 解压得到 commons-scxml-0.9.jar → 收集依赖 jar → javac -cp 编译 → java -cp 运行。与近年的 Commons 组件不同，0.9 的 bin 包不捆绑依赖 jar（实测包内只有主 jar、javadoc、sources 与文档），依赖必须单独收集。

5.2 下载与完整性校验

cd /opt/scxml-demo
curl -sO --max-time 120 https://downloads.apache.org/commons/scxml/binaries/commons-scxml-0.9-bin.tar.gz
curl -sO --max-time 60 https://downloads.apache.org/commons/scxml/binaries/commons-scxml-0.9-bin.tar.gz.sha256
ls -l commons-scxml-0.9-bin.tar.gz

-rw-r--r-- 1 root root 1733016 Oct 15 10:26 commons-scxml-0.9-bin.tar.gz

校验 sha256（期望值与实测值必须逐字一致）：

echo "期望: $(cut -d' ' -f1 commons-scxml-0.9-bin.tar.gz.sha256)"
echo "实测: $(sha256sum commons-scxml-0.9-bin.tar.gz | awk '{print $1}')"

期望: 887c8922a1b7a06452d7a0b1aa97e09b719340bc7f5fc57efe5324fe84f2708d
实测: 887c8922a1b7a06452d7a0b1aa97e09b719340bc7f5fc57efe5324fe84f2708d

⚠️ 注意：官方 .sha256 文件内含 *./scxml/binaries/ 路径前缀，直接用 sha256sum -c 会因路径不匹配而失败，按本文方式取出第一列哈希值人工比对即可。

5.3 解压

tar xzf commons-scxml-0.9-bin.tar.gz && ls commons-scxml-0.9/

apidocs
commons-scxml-0.9.jar
commons-scxml-0.9-javadoc.jar
commons-scxml-0.9-sources.jar
LICENSE.txt
NOTICE.txt
RELEASE-NOTES.txt

主 jar 信息（实测）：

ls -l commons-scxml-0.9/commons-scxml-0.9.jar

-rw-r--r-- 1 root root 175862 Nov 22  2008 commons-scxml-0.9/commons-scxml-0.9.jar

包内 apidocs/ 是完整 Javadoc 站点，离线环境可直接用浏览器查阅 API。

5.4 收集依赖 jar

从 Maven 中央仓库补齐 5 个依赖（与 4.6 节依赖树一一对应）：

cd /opt/scxml-demo/jar-run && mkdir -p lib
cp /opt/scxml-demo/commons-scxml-0.9/commons-scxml-0.9.jar lib/
cd lib
curl -sO https://repo1.maven.org/maven2/commons-logging/commons-logging/1.1.1/commons-logging-1.1.1.jar
curl -sO https://repo1.maven.org/maven2/commons-digester/commons-digester/1.8/commons-digester-1.8.jar
curl -sO https://repo1.maven.org/maven2/commons-beanutils/commons-beanutils/1.7.0/commons-beanutils-1.7.0.jar
curl -sO https://repo1.maven.org/maven2/commons-jexl/commons-jexl/1.1/commons-jexl-1.1.jar
curl -sO https://repo1.maven.org/maven2/xalan/xalan/2.7.2/xalan-2.7.2.jar
ls -l | awk '{print $5, $9}'

188671 commons-beanutils-1.7.0.jar
143602 commons-digester-1.8.jar
132165 commons-jexl-1.1.jar
60686 commons-logging-1.1.1.jar
175862 commons-scxml-0.9.jar
3154938 xalan-2.7.2.jar

5.5 javac 编译与 java 运行

把 4.5 节的验证源码复制到直跑目录，用 6 个 jar 作为 classpath 编译运行：

cd /opt/scxml-demo/jar-run
cp /opt/scxml-demo/scxml-demo/src/main/java/demo/TrafficLightDemo.java .
mkdir -p out
javac -encoding UTF-8 -cp lib/commons-scxml-0.9.jar:lib/commons-logging-1.1.1.jar:lib/commons-digester-1.8.jar:lib/commons-beanutils-1.7.0.jar:lib/commons-jexl-1.1.jar:lib/xalan-2.7.2.jar -d out TrafficLightDemo.java

Note: TrafficLightDemo.java uses unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.

Note 只是泛型原始类型提示（0.9 的 getStates() 返回裸 Set），不影响使用。注意类带 demo 包名，运行必须写全限定类名 demo.TrafficLightDemo：

java -Dfile.encoding=UTF-8 -cp out:lib/commons-scxml-0.9.jar:lib/commons-logging-1.1.1.jar:lib/commons-digester-1.8.jar:lib/commons-beanutils-1.7.0.jar:lib/commons-jexl-1.1.jar:lib/xalan-2.7.2.jar demo.TrafficLightDemo /opt/scxml-demo/scxml-demo/models/traffic-light.scxml

模型解析成功, 根状态个数=3
初始配置 -> red
发出第 1 个 timer 后 -> green
发出第 2 个 timer 后 -> yellow
发出第 3 个 timer 后 -> red

验证点：与方案 A 的输出逐行一致，jar 直跑链路在 CentOS 8 上同样可用。

5.6 官方交互式验证工具（免编译调试模型）

主 jar 内置了交互式 REPL：org.apache.commons.scxml.test.StandaloneJexlExpressions。它加载模型后打印序列化结果，随后从标准输入读事件（一行一个，多个事件用空格分隔，quit 退出），实时打印进入/退出/转移回调。不写一行 Java 代码即可验证模型（实时回显，发一次 timer 后退出）：

cd /opt/scxml-demo
CP=commons-scxml-0.9/commons-scxml-0.9.jar:jar-run/lib/commons-logging-1.1.1.jar:jar-run/lib/commons-digester-1.8.jar:jar-run/lib/commons-beanutils-1.7.0.jar:jar-run/lib/commons-jexl-1.1.jar:jar-run/lib/xalan-2.7.2.jar
printf 'timer\nquit\n' | java -cp $CP org.apache.commons.scxml.test.StandaloneJexlExpressions scxml-demo/models/traffic-light.scxml 2>&1 | tail -6

Oct 15, 2026 2:37:52 AM org.apache.commons.scxml.env.SimpleSCXMLListener onExit
INFO: /red
Oct 15, 2026 2:37:52 AM org.apache.commons.scxml.env.SimpleSCXMLListener onTransition
INFO: transition (event = timer, cond = null, from = /red, to = /green)
Oct 15, 2026 2:37:52 AM org.apache.commons.scxml.env.SimpleSCXMLListener onEntry
INFO: /green

工具以 JUL 日志格式打印每次状态变化：退出 /red、转移事件 timer、进入 /green，与 4.6 节 Java 驱动的结果吻合。

六、方案对比与选择建议

维度方案 A：Maven 依赖方案 B：官方 bin 包 + jar 直跑
依赖装配6 个 jar 自动解析，含传递依赖手工收集 5 个依赖 jar
是否联网首次构建需联网仅下载 jar 时需要联网
版本管控pom 统一声明，可锁定靠文件名区分，无锁
模型调试需写驱动代码可用官方 REPL 工具直接联调
适用场景常规工程开发离线服务器、遗留系统、纯模型验证

选型建议：有构建体系一律方案 A；临时验证模型或在无构建工具的老服务器上运行，方案 B 的 REPL 模式（5.6 节）是 0.9 生态里效率最高的调试手段。两者可共存：方案 A 开发、方案 B 分发。

七、配置说明

Commons SCXML 是库而非服务，没有独立配置文件，全部「配置」体现在两处。

一是 JVM 选型。单 JDK 场景 CentOS 8 的 Maven 可经 PATH 自动定位（见 4.2 节实测）；一旦机器上并存多个 JDK，必须显式指定（实时回显）：

export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk && echo "JAVA_HOME=$JAVA_HOME"

JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk

二是引擎行为参数。SCXMLExecutor 的三个构造参数（表达式引擎 Evaluator、事件派发器 EventDispatcher、错误上报 ErrorReporter）就是 0.9 的全部运行期配置面：默认示例传入 JexlEvaluator 与 SimpleErrorReporter，需要延时 <send> 时还要装配 SimpleScheduler（本专栏第 3、4 篇有完整示例）。运行日志走 commons-logging，默认绑定 JDK 自带的 JUL 输出，可通过常规 JCL 配置改接 log4j 等。

八、常见问题（FAQ）

Q1：dnf makecache 报 Failed to download metadata for repo 'appstream' 或 404？ 三个常见原因按顺序排查：其一，/etc/yum.repos.d/ 未按第二节改写，mirror.centos.org 已下线必失败；其二，改写后 URL 里的版本段是 8 而 $releasever 未固定，执行 echo '8.4.2105' > /etc/dnf/vars/releasever；其三，机器网络出口屏蔽了 aliyun 归档，可用其他 centos-vault 镜像替换 baseurl 中的域名。实测 vault.centos.org 直连被 403 拒绝（见第二节回显），不要从它下手。

Q2：想装 JDK 17 怎么办？ 8.4.2105 归档源实测没有 JDK 17 包（实时回显）：

dnf list --available java-17-openjdk-devel 2>&1 | tail -2

Error: No matching Packages to list

JDK 17 首次进入 CentOS 8 是 8.5.2111 的 AppStream。两条路：把 /etc/dnf/vars/releasever 改为 8.5.2111 后重刷缓存安装；或从 Adoptium 官方仓库安装 Temurin 17。本文作者已用 Temurin 17.0.20.1 完整验证过本专栏示例（JEXL 路线可行），但 JDK 8 与 0.9 同代，仍是首选。

Q3：JDK 17 上运行有什么注意点？ 实测可以跑通，要点有二：表达式引擎必须走 JEXL 路线（JexlEvaluator），0.9 备选的 JSP EL 路线需要额外装配 JSP/Servlet API；Java 侧根上下文要用配套的 JexlContext 而不是 SimpleContext，否则运行时报 SimpleContext cannot be cast to class org.apache.commons.scxml.env.jexl.JexlContext（完整报错见第 3 篇 3.2 节）。生产建议优先 JDK 8。

Q4：运行报 NoClassDefFoundError: org/apache/xml/utils/PrefixResolver 怎么办？ 最典型的坑：模型解析器引用了 Xalan 内部类，而 0.9 的 POM 把 xalan 声明为 optional 依赖。实测报错形如：

[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.6.4:java (default-cli) on project scxml-demo: An exception occurred while executing the Java class. org/apache/xml/utils/PrefixResolver: org.apache.xml.utils.PrefixResolver -> [Help 1]

解法：pom 显式加入 xalan:xalan:2.7.2（见 4.3 节）；jar 直跑场景把 xalan-2.7.2.jar 放进 classpath（见 5.4 节）。

Q5：Maven 3.5.4 这么老，编译示例工程会有插件兼容问题吗？ 实测没有：maven.compiler.source/target=8 属性在 3.5.4 的默认编译插件下工作正常，mvn clean compile BUILD SUCCESS（见 4.6 节回显）。保持 pom 里 maven.compiler.source/target 的显式声明即可，无需升级 Maven。

Q6：控制台中文输出全是问号？ CentOS 8 最小安装默认 LANG=POSIX，JVM 按字节输出。解法：运行时加 -Dfile.encoding=UTF-8（本文所有 java 命令均已携带），或在 shell 会话 export LANG=C.UTF-8。通过 mvn exec:java 运行时该参数要经 MAVEN_OPTS 传入，直接用 java -cp 更可控。

九、卸载与清理

移除工程与实验目录（实时回显）：

rm -rf /opt/scxml-demo/scxml-demo /opt/scxml-demo/jar-run /opt/scxml-demo/commons-scxml-0.9 /opt/scxml-demo/commons-scxml-0.9-bin.tar.gz /opt/scxml-demo/commons-scxml-0.9-bin.tar.gz.sha256
ls /opt/scxml-demo 2>&1

ls: cannot access '/opt/scxml-demo': No such file or directory

移除 Maven 本地仓库中的相关缓存（影响所有工程，慎用）：

rm -rf $HOME/.m2/repository/commons-scxml $HOME/.m2/repository/commons-jexl $HOME/.m2/repository/xalan

卸载 JDK 与 Maven（仅当不再需要）。先以 --assumeno 预演确认将删除的包（实时回显）：

dnf remove --assumeno java-1.8.0-openjdk-devel maven 2>&1 | grep -A8 'Removing'

# 输出节选（实测）
Removing:
 java-1.8.0-openjdk-devel   x86_64   1:1.8.0.312.b07-1.el8_4   @appstream
 maven                      noarch   1:3.5.4-5.module_el8.0.0+39+6a9b6e22   @appstream
Operation aborted.

Operation aborted. 正是 --assumeno 预演后未执行的标志。确认无误后去掉该参数真正执行：

dnf remove -y java-1.8.0-openjdk-devel maven && dnf autoremove -y

如需把软件源还原到官方 EOL 配置（一般不必要），删除版本钉子与 baseurl 改写即可：

rm -f /etc/dnf/vars/releasever && sed -i 's|baseurl=https://mirrors.aliyun.com/centos-vault|#baseurl=http://mirror.centos.org/\$contentdir|; s|#mirrorlist=|mirrorlist=|' /etc/yum.repos.d/CentOS-*.repo

十、参考链接

  1. Apache Commons SCXML 官方主页：https://commons.apache.org/proper/commons-scxml/
  2. Apache Commons SCXML 官方下载目录：https://downloads.apache.org/commons/scxml/
  3. Commons SCXML 0.9 发布说明：https://downloads.apache.org/commons/scxml/RELEASE-NOTES.txt
  4. Maven 中央仓库坐标页：https://repo1.maven.org/maven2/commons-scxml/commons-scxml/
  5. W3C State Chart XML (SCXML) 规范：https://www.w3.org/TR/scxml/
  6. Apache Commons Dormant 项目名单：https://commons.apache.org/dormant.html
  7. 阿里云 CentOS 归档镜像：https://mirrors.aliyun.com/centos-vault/