Akka新手求助：运行可执行Jar时出现$akka.stream-blocking io dispatcher解析错误

嘿，作为Akka新手碰到这个配置问题太正常了，别慌！咱们来一步步搞定这个Could not resolve substitution to value :$akka.stream-blocking io dispatcher的报错。

错误根源 #

这个问题本质是HOCON配置文件的变量引用格式完全不符合规范。Akka用HOCON格式管理配置，要引用已定义的配置项必须遵守两个核心规则：

• 变量引用必须用${}包裹，不能只写$
• 配置项的层级用**点(.)分隔，单词之间用连字符(-)**区分，不能用横杠代替层级点，更不能随意加空格

你提到的$akka.stream-blocking io dispatcher刚好踩了所有坑：缺了包裹变量的大括号，把层级分隔符点写成了横杠，还多了无效空格，导致Akka根本找不到对应的配置项。

修复步骤 #

1. 修正reference.conf里的错误配置行
   找到你配置中使用$akka.stream-blocking io dispatcher的地方，替换成Akka默认阻塞IO调度器的正确引用格式：

${akka.stream.blocking-io-dispatcher}

举个实际的例子，如果你之前的配置是：

akka.actor.custom-dispatcher = $akka.stream-blocking io dispatcher

改成：

akka.actor.custom-dispatcher = ${akka.stream.blocking-io-dispatcher}

2. 验证配置拼写准确性
   确认你引用的配置项路径完全正确，Akka官方默认的阻塞IO调度器路径就是akka.stream.blocking-io-dispatcher，别写错字母或者符号。

3. 重新打包并运行
   执行mvn assembly:single重新生成可执行Jar，之后再运行Jar包，这个解析错误应该就消失了。

额外提示 #

如果是你自定义了阻塞IO调度器的配置，也要确保自定义配置和引用格式一致，比如：

akka.stream {
  custom-blocking-dispatcher {
    type = Dispatcher
    executor = "thread-pool-executor"
    thread-pool-executor {
      core-pool-size-min = 4
      core-pool-size-max = 4
    }
  }
}

# 引用自定义调度器
akka.actor.my-actor {
  dispatcher = ${akka.stream.custom-blocking-dispatcher}
}

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