Quarkus中如何实现根路径端点的访问与重定向？

问题原因 #

Quarkus默认启用欢迎页机制：当访问根路径/时，会优先匹配static/目录下的index.html，这个处理逻辑的优先级高于JAX-RS端点和自定义过滤器，所以你的@Path("/")控制器方法永远不会被触发，导致要么直接打开index.html，要么因配置冲突返回"Resource not found"。

解决方案 #

方案一：禁用默认欢迎页，让JAX-RS端点接管根路径 #

在application.properties中添加配置，关闭自动欢迎页映射：

quarkus.http.static-resources.welcome-page=false

配置生效后，Quarkus不再自动将/指向static/index.html，你的DirectorController的@GET方法会正常触发，返回重定向响应。

方案二：用Vert.x路由实现重定向（不影响静态资源访问） #

如果需要保留index.html的直接访问（比如通过/index.html路径），同时修改根路径的行为，可以使用Vert.x路由（优先级高于静态资源处理器和JAX-RS）：

import io.quarkus.vertx.http.runtime.filters.Filters;
import io.vertx.ext.web.Router;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.enterprise.event.Observes;

@ApplicationScoped
public class RootRedirectRoute {

    void configureRoutes(@Observes Router router) {
        // 捕获根路径GET请求
        router.get("/").handler(context -> {
            context.response()
                    .setStatusCode(301) // 永久重定向
                    .putHeader("Location", "你的目标路径") // 替换为实际重定向地址
                    .end();
        });
    }
}

这个方案下，访问/会触发重定向，而/index.html仍然可以正常访问静态页面。

方案三：调整静态资源结构（可选） #

将static/index.html移动到子目录（比如static/app/index.html），这样Quarkus的欢迎页机制无法匹配到根路径的index.html，你的JAX-RS端点即可生效。但这种方法灵活性较低，仅适合不需要直接通过/index.html访问页面的场景。

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