XSLT路径需按类路径写，如xsl/transform.xsl；传参须用setHeader设CamelXsltParameters为Map，不可用simple直接赋值。
Camel中用 xslt 转换 XML 时路径不生效？
JBoss Fuse（基于 Apache Camel）里最常用的 XML 转换方式是 xslt 组件，但很多人卡在 XSLT 文件找不到或参数传不进去。根本原因通常是类路径解析逻辑和 Fuse 的 OSGi 类加载机制冲突。
-
xslt默认从 classpath 加载 XSLT，不是文件系统路径 —— 写成file:/opt/fuse/xsl/transform.xsl会静默失败 - 若 XSLT 放在
src/main/resources下，直接写xslt:transform.xsl即可；放在子目录（如resources/xsl/），必须写全路径xslt:xsl/transform.xsl - 需要传参数给 XSLT？用
setHeader设置CamelXsltParameters，值为Map，不能直接用simple表达式塞进 header
<route><from uri="direct:in"></from><setheader name="CamelXsltParameters"><simple>#{'map:{"inputId": "${header.id}", "env": "prod"}}>
</simple></setheader><to uri="xslt:xsl/transform.xsl"></to></route>
用 jaxb 反序列化后再改字段，比 XSLT 更可控？
当 XML 结构固定、转换逻辑偏业务逻辑（比如把 jaxb 先转 Java 对象，再用普通代码处理，更利于单元测试和维护。
- 确保 JAXB context 能扫描到你的 POJO 类：Fuse 默认不自动注册，需显式配置
JaxbDataFormat并传入Class[] - POJO 字段名与 XML 元素名不一致？加
@XmlElement(name = "user-name")注解，别依赖默认映射 - 避免在 route 中反复 new
JaxbDataFormat—— 它不是线程安全的，应作为 bean 声明在 Spring XML 或 Blueprint 中
validate + xslt 连用时，XML 校验失败后没走 error handler？
很多人想先校验 XML 是否符合 XSD，再做转换，结果 validate 报错后 route 直接中断，onException 不触发。这是因为 validate 抛的是 ValidationException，而默认 error handler 捕获的是 Exception 或其子类，但部分老版本 Camel 的 ValidationException 并未继承 RuntimeException。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 显式在
onException中声明捕获org.apache.camel.ValidationException - 不要把
validate和xslt放在同一 route 的同一行 —— 分开成两个独立处理步骤，便于定位失败环节 - XSD 文件路径同样受 classpath 限制；若引用了外部命名空间（如
xs:import namespace="http://example.com/ns"），需确保该命名空间对应 XSD 也在 classpath 中且被正确注册
Fuse 6.3+ 中 smooks 插件已弃用，替代方案是什么？
早期 Fuse 项目常用 smooks 做复杂 XML/CSV/Java 对象混合转换，但自 Fuse 6.3 起，smooks-camel 不再预装，且与较新版本 Smooks（v1.7+）存在 OSGi 包冲突。强行安装容易引发 ClassNotFoundException 或 InvalidBundleException。
- 轻量场景：用
xslt+ 自定义Function（通过net.sf.saxon.TransformerFactoryImpl注册扩展函数）补足逻辑缺失 - 结构复杂、需多源数据聚合：改用
camel-jacksonxml先转 JSON，再用jsonpath+simple处理，最后用jacksonxml回写 XML - 绝对避免在生产环境手动 drop
smooksjar 到deploy/—— OSGi bundle 生命周期管理会失控，重启后可能不激活
真正麻烦的从来不是语法怎么写，而是 XSLT 里的命名空间前缀是否和输入 XML 一致、JAXB 的 @XmlRootElement 是否漏标、还有那些没报错但默默跳过校验的 validate 配置。
