Vaadin 24 Flow项目中Montserrat字体未加载问题求助

1. 检查主题样式配置文件 #

找到项目中frontend/themes/[你的主题名称]/styles.css文件，确认是否包含Montserrat字体的引入与全局字体设置。正确配置示例：

@import url('https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;700&display=swap');

:root {
  --lumo-font-family: Montserrat, sans-serif;
}

如果没有上述代码，手动添加后保存。

2. 确认主题注解配置 #

检查项目主配置类（如Application.java），确保@Theme注解指定的是创建项目时选择的主题名称：

@Theme(value = "your-theme-name")
public class Application extends SpringBootServletInitializer {
    // 项目代码
}

若主题名称不匹配，修正为创建时的主题名。

3. 清理缓存并重启项目 #

• Maven项目执行缓存清理命令：./mvnw vaadin:clean
• Gradle项目执行缓存清理命令：./gradlew vaadinClean
  清理完成后重新构建并启动项目，确保前端资源重新编译。

4. 处理Google Fonts访问问题 #

若服务器无法访问Google Fonts，可将字体文件本地引入：

1. 下载Montserrat各字重字体文件，放入frontend/themes/[你的主题名称]/fonts目录
2. 在styles.css中通过本地路径引入：

@font-face {
  font-family: 'Montserrat';
  src: url('./fonts/Montserrat-Regular.ttf') format('truetype');
  font-weight: 400;
  font-style: normal;
}
/* 按需添加其他字重的font-face配置 */

:root {
  --lumo-font-family: Montserrat, sans-serif;
}

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