Quarkus+Qute+MessageBundle配置报错及键名映射问题求助

一、彻底解决编码问题 #

之前用终端创建文件临时解决了编码报错，但要从根源避免重复踩坑：

• IntelliJ全局编码配置：打开File > Settings > Editor > File Encodings，将Project Encoding、Default encoding for properties files设为UTF-8，同时勾选Transparent native-to-ascii conversion。
• 构建工具编码强制：在项目构建文件中添加编码约束：
  Maven（pom.xml）：

  <properties>
      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  </properties>
  

  Gradle（build.gradle）：

  tasks.withType(JavaCompile) {
      options.encoding = 'UTF-8'
  }
  

二、解决短横线键与小驼峰方法的映射问题 #

Quarkus MessageBundle默认支持kebab-case（短横线）到camelCase（小驼峰）的自动映射，按以下步骤排查修复：

1. 显式指定@Message的key属性 #

如果自动映射未生效，可在接口方法上显式绑定配置键：

@MessageBundle
public interface AppMessages {
    @Message(key = "invalid-data")
    String invalidData();
}

2. 检查Quarkus配置是否覆盖默认行为 #

打开application.properties，确认没有添加禁用映射的配置：
避免出现类似quarkus.qute.message-bundle.kebab-case-to-camel-case=false的配置，默认该映射是开启状态。

3. 清理构建缓存 #

Quarkus开发模式的缓存可能残留旧配置，执行清理命令：

# Maven
./mvnw clean
# Gradle
./gradlew clean

之后重新启动开发模式：

# Maven
./mvnw quarkus:dev
# Gradle
./gradlew quarkusDev

4. 升级Quarkus版本 #

旧版本Quarkus可能存在映射bug，建议升级到最新稳定版（如3.x系列），修改pom.xml中的版本号：

<properties>
    <quarkus.platform.version>3.12.0</quarkus.platform.version>
</properties>

验证 #

完成以上操作后重新构建项目，invalid-data配置键应该能正确映射到invalidData()方法，不再抛出找不到方法的异常。

内容的提问来源于stack exchange，提问作者Luciano Borges