SBT 1.12.11无法处理netty-4.2.13.Final，依赖解析失败求助

问题根源 #

netty-codec-native-quic在Netty 4.2.x版本中采用了动态打包变量+平台分类器的发布策略，其POM文件中使用${packaging.type}变量适配不同平台的打包格式。但SBT的Ivy2解析器对Maven POM中的动态变量替换支持不完善，无法将${packaging.type}解析为实际文件后缀（如jar），直接将变量名拼接到下载URL中，导致URI包含非法字符，最终下载失败。

缓存异常的原因 #

Ivy解析依赖时会将POM转换为Ivy格式配置文件：

• ivy-4.2.13.Final.xml.original是未做变量替换的原始转换文件，保留了${packaging.type}变量；
• 正常情况下Ivy会生成替换变量后的ivy-4.2.13.Final.xml，但由于变量解析失败，该文件无法生成，导致依赖无法加载。

兼容问题本质 #

Netty 4.2.x对native组件的发布逻辑做了调整，依赖Maven原生的变量替换机制，而SBT默认的Ivy2解析器在处理这类动态依赖定义时存在局限性，相比之下Coursier解析器能更好适配这种现代Maven依赖发布格式。

解决办法 #

1. 手动指定平台分类器 #

排除netty-all传递的未解析依赖，手动添加对应平台的netty-codec-native-quic依赖：

// 排除netty-all中的netty-codec-native-quic传递依赖
libraryDependencies += "io.netty" % "netty-all" % "4.2.13.Final" exclude ("io.netty", "netty-codec-native-quic")

// 根据操作系统添加对应分类器的依赖，示例为Linux x86_64
libraryDependencies += "io.netty" % "netty-codec-native-quic" % "4.2.13.Final" classifier "linux-x86_64"

常见平台分类器：linux-x86_64、linux-aarch64、osx-x86_64、osx-aarch64、windows-x86_64。

2. 切换到Coursier解析器 #

Coursier对Maven动态变量的支持更完善，能自动处理Netty native组件的平台适配：

ThisBuild / useCoursier := true

切换后执行sbt update即可自动下载对应平台的依赖。

3. 手动修复缓存（不推荐） #

清理Ivy缓存中该依赖的目录，手动下载对应平台的jar包和POM文件放到缓存路径，再将ivy-4.2.13.Final.xml.original中的${packaging.type}替换为jar，重命名为ivy-4.2.13.Final.xml。此方式繁琐易出错，仅作临时应急方案。

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