Ktor路由级插件异常拦截所有请求问题求助

问题原因 #

你的authenticateLoggedInUser扩展函数使用了错误的路由构建方式：将子路由的注册逻辑放在了handle块中。handle是用来定义请求处理逻辑的，而子路由的注册应该在路由构建阶段完成，而非请求处理阶段。这种错误写法会导致子路由没有正确挂载到安装插件的路由下，进而使得插件的作用范围意外扩大，影响到其他路由。

解决方案 #

1. 修正authenticateLoggedInUser扩展函数 #

将子路由的构建逻辑从handle中移出，直接执行build()：

fun Route.authenticateLoggedInUser(build: suspend Route.() -> Unit) {
    install(LoggedInUserAuthPlugin) {}
    // 直接构建子路由，而非在请求处理阶段执行
    build()
}

2. 保留正确的withLoggedInUser写法 #

withLoggedInUser的设计是给单个HTTP方法路由添加请求处理逻辑，写法本身正确，无需修改：

fun Route.withLoggedInUser(build: suspend PipelineContext<Unit, ApplicationCall>.() -> Unit) {
    install(LoggedInUserAuthPlugin) {}
    handle { build() }
}

3. 插件核心逻辑无需修改 #

你的路由级插件本身逻辑是正确的，createRouteScopedPlugin确保插件仅绑定到安装它的路由及其子路由，事件监听只会在请求匹配目标路由时触发：

class LoggedInUserAuthConfiguration

val LoggedInUserAuthPlugin =
    createRouteScopedPlugin(name = "LoggedInUserAuthPlugin", ::LoggedInUserAuthConfiguration) {
        with(pluginConfig) {
            on(AuthenticationChecked) { call ->
                call.principal<JWTPrincipal>()?.let {
                    call.userId ?: call.respond(HttpStatusCode.Forbidden)
                } ?: call.respond(HttpStatusCode.Unauthorized)
            }
        }
    }

验证使用方式 #

修正后可继续按原方式使用两个扩展函数：

// 方式1：给整个路由组添加认证
fun Route.addRoute() {
    authenticateLoggedInUser {
        route("/endpoint") {
            post {
                // 业务逻辑
            }
            get {
                // 业务逻辑
            }
        }
    }
}

// 方式2：给单个HTTP方法路由添加认证
fun Route.addRoute() {
    route("/endpoint") {
        method(HttpMethod.Post) {
            withLoggedInUser {
                // 业务逻辑
            }
        }
        method(HttpMethod.Get) {
            withLoggedInUser {
                // 业务逻辑
            }
        }
    }
}

原理说明 #

Ktor的路由级插件通过createRouteScopedPlugin创建后，会严格绑定到安装它的路由节点及其所有子节点。修正authenticateLoggedInUser的写法后，子路由会正确挂载到目标路由下，插件的事件监听只会在请求匹配该路由路径时触发，不会再波及其他无关路由。

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