部署在Railway上的Spring Boot应用出现白标错误页问题

1. 检查前端资源的打包路径 #

你的项目分negocio（后端）和web（前端）模块，首先要确保web模块的XHTML页面、静态资源在打包后被正确包含到最终产物中：

• 确认XHTML文件放在unicine/web/src/main/webapp/目录下（这是Java EE web项目的标准资源目录），若放在其他目录，Spring Boot可能无法自动识别。
• 检查Maven/Gradle的打包配置，确保web模块的资源被正确复制到构建产物的对应目录。比如Maven的pom.xml可添加如下配置：

<build>
    <resources>
        <resource>
            <directory>src/main/webapp</directory>
            <targetPath>META-INF/resources</targetPath>
            <includes>
                <include>**/*.xhtml</include>
                <include>**/*.css</include>
                <include>**/*.js</include>
            </includes>
        </resource>
    </resources>
</build>

2. 验证视图解析器与JSF依赖配置 #

因为使用的是XHTML页面，大概率依赖JSF，需确保相关配置正确：

• 检查pom.xml中JSF依赖的范围，不要设为provided（部署到Railway需要将依赖打包进jar包），示例配置：

<dependency>
    <groupId>org.glassfish</groupId>
    <artifactId>javax.faces</artifactId>
    <version>2.3.14</version>
</dependency>

• 在application.properties中配置正确的视图前缀和后缀，让Spring能正确定位XHTML文件：

spring.mvc.view.prefix=/
spring.mvc.view.suffix=.xhtml

3. 排查首页跳转类的有效性 #

你配置的首页跳转类在部署后失效，可从以下几点检查：

• 确认跳转类使用了@Controller注解，且映射路径正确。示例代码：

@Controller
public class HomeController {
    @GetMapping("/")
    public String redirectToHome() {
        return "index"; // 对应index.xhtml，需和视图解析器配置匹配
    }
}

• 确保跳转类所在的包被Spring Boot扫描到，若主启动类不在根包下，需在启动类上添加@ComponentScan(basePackages = "co.edu.uniquindio.unicine")。

4. 查看Railway的日志信息 #

• 登录Railway控制台，查看应用运行日志，搜索是否存在FileNotFoundException或视图解析相关错误，这类日志能直接定位到具体页面缺失或配置问题。
• 检查构建日志，确认Maven/Gradle打包过程中是否有资源未被复制的警告或错误。

5. 检查应用上下文路径 #

• 查看application.properties是否设置了上下文路径：

server.servlet.context-path=/unicine

如果有该配置，访问路径需要加上上下文路径，即https://unicine.up.railway.app/unicine，而非直接访问根路径。

6. 验证最终jar包的内容 #

可以下载Railway上构建好的jar包，解压后查看是否包含index.xhtml、login_admin.xhtml等文件，确认它们是否位于BOOT-INF/classes/META-INF/resources/目录下（Spring Boot打包后的标准静态资源位置）。

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