Spring Boot+Vaadin部署至Railway遇资源缺失及index.html找不到问题

问题根源分析 #

你遇到的两个错误本质上都是生产环境下Vaadin前端资源构建/配置异常导致的：

1. 首次错误：DevModeServletContextInitializer$DevModeServletContextListener初始化失败，是因为Railway作为生产环境，却触发了Vaadin的开发模式监听器；找不到./generated/jar-resources资源，是因为构建过程未正确生成Vaadin编译后的前端资源。
2. 第二次错误：找不到index.html，是因为生产构建时未自动生成Vaadin入口页面，或者资源未被正确打包到Jar包的类路径中。

具体解决步骤 #

1. 强制禁用Vaadin开发模式 #

在项目配置文件中明确关闭开发模式：

• 如果用application.properties：

  vaadin.dev-mode.enabled=false
  vaadin.production-mode=true
  

• 如果用application.yml：

  vaadin:
    dev-mode:
      enabled: false
    production-mode: true
  

2. 修正构建配置，确保前端资源正确生成打包 #

Maven项目（pom.xml）

确保添加生产环境Profile，让Vaadin插件在构建时自动编译前端资源：

<profiles>
    <profile>
        <id>production</id>
        <properties>
            <vaadin.productionMode>true</vaadin.productionMode>
        </properties>
        <build>
            <plugins>
                <plugin>
                    <groupId>com.vaadin</groupId>
                    <artifactId>vaadin-maven-plugin</artifactId>
                    <version>${vaadin.version}</version>
                    <executions>
                        <execution>
                            <goals>
                                <goal>build-frontend</goal>
                            </goals>
                            <phase>compile</phase>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

Gradle项目（build.gradle）

配置生产模式任务，确保前端资源被打包到Jar中：

vaadin {
    productionMode = project.hasProperty("vaadin.productionMode")
}

// 确保编译Java前准备前端资源
tasks.withType(JavaCompile) {
    dependsOn(vaadinPrepareFrontend)
}

// 将生成的前端资源打包到Jar的META-INF/resources目录
jar {
    dependsOn(vaadinBuildFrontend)
    from('build/frontend/generated/jar-resources') {
        into('META-INF/resources')
    }
}

3. 配置Railway的构建命令 #

在Railway项目的构建设置中，使用生产环境的构建指令：

• Maven项目：mvn clean package -Pproduction
• Gradle项目：./gradlew clean build -Pvaadin.productionMode=true

4. 本地验证打包结果 #

本地执行上述构建命令后，解压生成的Jar包，检查以下内容：

• META-INF/resources/VAADIN目录是否存在，且包含编译后的前端资源（如js、css文件）
• META-INF/resources/index.html是否存在（Vaadin生产构建会自动生成该文件）

总结 #

这些错误核心是开发模式侵入生产环境和前端资源构建不完整，通过关闭开发模式、配置生产构建流程、指定正确的Railway构建命令，即可解决问题。

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