Drogon框架中过滤器与CORS配置的常见问题解析

过滤器注册顺序的重要性

在使用Drogon框架开发Web应用时，许多开发者会遇到过滤器不生效的问题，特别是在处理跨域资源共享(CORS)时。一个典型的场景是开发者创建了自定义过滤器类，正确实现了doFilter方法，但在实际请求中却发现过滤器逻辑没有被执行。

问题根源分析

问题的核心在于Drogon框架中组件注册的顺序。框架要求所有处理器(handler)必须在调用run()方法之前完成注册。如果在run()之后才注册处理器，框架将无法正确建立请求路由与过滤器的关联关系。

正确的实现方式

正确的做法是将所有路由注册逻辑放在run()调用之前。对于需要初始化的服务配置，可以使用registerBeginningAdvice方法，但必须确保其中的路由注册代码在run()之前执行。

int main()
{
    auto authFilter = std::make_shared<AuthFilter>();
    
    app()
        .loadConfigFile("./config.json")
        .setLogPath("./build/log")
        .registerFilter(authFilter)
        .registerHandler("/api/auth/isUserExist?username={username}", &usernameCheck, {Get, "AuthFilter"})
        .registerHandler("/api/auth/signup", &signUpHandler, {Post, "AuthFilter"})
        .registerHandler("/api/auth/signin", &signInHandler, {Post, "AuthFilter"})
        .run();
    return EXIT_SUCCESS;
}

过滤器实现细节

在实现CORS过滤器时，除了基本的Access-Control-Allow-Origin头部外，通常还需要处理预检请求(OPTIONS)和其他相关头部：

void doFilter(const drogon::HttpRequestPtr &req,
              drogon::FilterCallback &&fcb,
              drogon::FilterChainCallback &&fccb) override
{
    // 处理OPTIONS预检请求
    if(req->method() == Options)
    {
        auto resp = HttpResponse::newHttpResponse();
        resp->addHeader("Access-Control-Allow-Origin", "http://localhost:xxxx");
        resp->addHeader("Access-Control-Allow-Methods", "GET,POST,OPTIONS");
        resp->addHeader("Access-Control-Allow-Headers", "Content-Type");
        return fcb(resp);
    }
    
    // 正常请求处理
    auto resp = HttpResponse::newHttpResponse();
    resp->addHeader("Access-Control-Allow-Origin", "http://localhost:xxxx");
    fccb(); // 继续处理链
}

不同控制器的差异化策略

对于需要为不同控制器应用不同CORS策略的场景，可以通过以下方式实现：

1. 创建多个过滤器类，每个类实现不同的CORS策略
2. 在注册路由时，为不同路由指定不同的过滤器
3. 在过滤器内部根据请求路径动态决定应用的策略

性能考量

虽然过滤器提供了灵活的请求处理机制，但过度使用会影响性能。对于简单的CORS需求，可以考虑使用registerPostHandlingAdvice全局后处理建议，这种方式通常比过滤器更高效。

总结

Drogon框架的过滤器机制虽然强大，但需要注意注册顺序和正确使用。理解框架的生命周期和组件初始化顺序是解决问题的关键。对于CORS这类常见需求，合理设计过滤器逻辑可以大大提高开发效率和系统安全性。