在 Log4j2 的 YAML 配置中，可通过 Properties.Property 下的列表形式声明多个属性变量，但必须严格保证 YAML 缩进层级正确，否则变量将无法被解析，导致占位符（如 ${log-path}）原样保留而未替换。
在 log4j2 的 yaml 配置中，可通过 `properties.property` 下的列表形式声明多个属性变量，但必须严格保证 yaml 缩进层级正确，否则变量将无法被解析，导致占位符（如 `${log-path}`）原样保留而未替换。
Log4j2 支持使用 YAML 格式替代 XML 配置，但在声明多个 Properties 节点。
✅ 正确的多属性 YAML 声明方式
Log4j2 要求 Properties 必须是 Configuration 的直接子项，且 Property 必须是 Properties 的唯一键名（不能写成 Properties: [ {name: ..., value: ...} ]），其值为 YAML 序列（即 - 开头的列表），且所有 - 项必须保持统一缩进（推荐 2 或 4 空格，禁止混用 Tab）：
Configuration:
packages: "com.mypackage"
Properties:
Property:
- name: log-path
value: "/var/work/logs/my-service"
- name: log-name
value: "my-service"
Appenders:
RollingFile:
name: File
fileName: "${log-path}/${log-name}.log" # ✅ 双引号包裹确保字符串解析
filePattern: "${log-path}/${log-name}-%d{yyyy-MM-dd}-%i.log.gz"
# ... 其他配置保持不变
⚠️ 关键细节：
Property:后必须换行并缩进，每个- name: ...项顶格对齐（如都缩进 6 空格）；Properties和Appenders、Loggers等同级，均隶属于Configuration；- 所有占位符
${...}建议用双引号包裹（如"${log-path}/app.log"），避免 YAML 解析器误判为 null 或布尔值；Loggers必须缩进在Configuration下，绝不可与Configuration同级（常见错误！）。
❌ 典型错误示例（导致变量失效）
Configuration:
packages: "com.mypackage"
Properties:
Property:
- name: log-path
value: "/logs"
# ↓ 错误：Loggers 顶格书写 → YAML 解析为 Configuration 外部节点 → Properties 被忽略！
Loggers: # ← 危险！此行应缩进至 Configuration 下（如 2 空格）
Root:
level: info
此时 Log4j2 实际加载的配置中 Properties 为空，所有 ${...} 占位符均不替换，日志文件名就变成字面量 "${log-path}/${log-name}.log"。
? 验证与调试建议
-
启用 Log4j2 内部日志：启动时添加 JVM 参数
-Dlog4j2.debug=true，观察控制台是否输出Found 2 properties； -
检查缩进一致性：用编辑器显示空格/Tab（如 VS Code 中按
Ctrl+Shift+P→ “Toggle Render Whitespace”）； - 优先使用 2 空格缩进（Log4j2 官方示例惯例），避免混合 Tab 与空格；
-
依赖确认：确保
jackson-dataformat-yaml和jackson-databind在 classpath 中（Log4j2 2.9+ 必需）：
<dependency><groupid>com.fasterxml.jackson.dataformat</groupid><artifactid>jackson-dataformat-yaml</artifactid><version>2.15.3</version></dependency>
✅ 总结
Log4j2 YAML 完全支持声明任意数量的属性变量，核心约束仅有一条：Properties.Property 必须作为 Configuration 的合法子结构被正确解析。只要严格遵循 YAML 缩进规范（Configuration → Properties → Property → - name/value 四级缩进），${log-path} 和 ${log-name} 就能如期替换，无需降级为单变量或回退 XML。配置即代码，缩进即契约。
