Spring Boot集成JSF(Primefaces)项目无法读取properties文件问题求助

你遇到的问题本质是JSF/Primefaces默认的消息资源查找逻辑和Spring Boot可执行WAR包的类加载结构不匹配，按以下步骤配置即可解决：

• 规范资源文件放置与命名
  所有国际化properties文件统一放在src/main/resources根目录，或其子目录（如src/main/resources/i18n），命名遵循[basename]_[语言编码]_[国家编码].properties规则，比如默认文件messages.properties，中文文件messages_zh_CN.properties，英文文件messages_en.properties。

• 配置JSF资源绑定，两种配置方式二选一即可：

方式1：通过faces-config.xml配置 #

在src/main/webapp/WEB-INF/faces-config.xml中添加如下配置：

<application>
    <!-- 配置消息资源绑定 -->
    <resource-bundle>
        <!-- 如果properties放在i18n子目录，此处写i18n.messages -->
        <base-name>messages</base-name>
        <!-- 页面上EL表达式引用的变量名 -->
        <var>msg</var>
    </resource-bundle>
    <!-- 可选：配置默认字符编码为UTF-8避免中文乱码 -->
    <locale-config>
        <default-locale>zh_CN</default-locale>
        <supported-locale>en</supported-locale>
    </locale-config>
</application>

方式2：通过Spring Bean集成（推荐，可复用Spring的MessageSource能力） #

在Spring Boot启动类或配置类中添加如下Bean：

import org.springframework.context.MessageSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.ResourceBundleMessageSource;

@Configuration
public class JsfConfig {
    @Bean
    public MessageSource messageSource() {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        // 此处配置对应properties的basename，多路径用逗号分隔
        messageSource.setBasename("messages");
        messageSource.setDefaultEncoding("UTF-8");
        return messageSource;
    }
}

同时配置JSF的EL解析器可直接引用Spring的MessageSource，或在后台业务代码中直接注入MessageSource获取消息。

• 验证配置
  页面引用示例：<h:outputText value="#{msg.welcomeTip}" />，其中welcomeTip为properties文件中定义的key
  后台获取消息示例：

@Autowired
private MessageSource messageSource;

public String getMessage(String key) {
    return messageSource.getMessage(key, null, FacesContext.getCurrentInstance().getViewRoot().getLocale());
}

• 常见排查点
  • 执行mvn package后解压WAR包，检查WEB-INF/classes目录下是否存在你编写的properties文件
  • 确保base-name配置不需要加classpath:前缀，JSF默认从类路径根路径查找资源
  • properties文件保存时选择UTF-8编码，避免中文乱码问题

内容的提问来源于stack exchange，提问作者Ekaterina Ivanova iceja.net