在ColdFusion中获取用户请求URL（有效/无效）并自定义路由处理

要绕过Lucee默认的404错误、捕获请求URL并手动处理，核心是利用Lucee的onMissingTemplate方法——这个方法会在请求的模板/文件不存在时自动触发，是实现自定义路由的关键入口。

基础实现示例 #

在你的Application.cfc中添加以下逻辑：

component {
    this.name = "CustomRouterApplication";
    this.applicationTimeout = createTimeSpan(0, 1, 0, 0);

    // 禁用Lucee默认的自定义错误页（可选，避免干扰自定义处理）
    this.errorPage = "";

    function onMissingTemplate(targetPage) {
        // 获取完整请求URL（包含查询字符串）
        var fullRequestURL = cgi.REQUEST_URL;
        if (len(cgi.QUERY_STRING)) {
            fullRequestURL &= "?" & cgi.QUERY_STRING;
        }

        // 调用自定义路由处理逻辑
        handleCustomRoute(fullRequestURL);

        // 返回true告知Lucee：请求已处理，无需抛出404错误
        return true;
    }

    function handleCustomRoute(requestURL) {
        // 这里替换为你的路由逻辑：解析URL、匹配规则、渲染页面等
        writeOutput("捕获到请求：" & requestURL);
        // 示例：根据URL渲染不同视图
        // if (requestURL contains "/user/") { include "views/user.cfm"; }
    }
}

进阶：过滤静态资源 #

如果需要保留静态资源（如CSS、JS、图片）的默认404处理，可在onMissingTemplate中添加扩展名判断：

function onMissingTemplate(targetPage) {
    // 定义无需自定义处理的静态资源扩展名
    var staticExtensions = ["css", "js", "jpg", "png", "gif", "svg", "ico"];
    var fileExt = listLast(targetPage, ".");

    // 静态资源直接返回false，让Lucee处理默认404
    if (arrayFind(staticExtensions, fileExt)) {
        return false;
    }

    // 动态请求走自定义路由
    var fullRequestURL = cgi.REQUEST_URL;
    if (len(cgi.QUERY_STRING)) {
        fullRequestURL &= "?" & cgi.QUERY_STRING;
    }

    handleCustomRoute(fullRequestURL);
    return true;
}

关键说明 #

• targetPage参数：直接提供请求的相对路径（如/invalid/path）
• cgi.REQUEST_URL：获取完整的请求URL（包含协议、域名、路径）
• 返回true：阻止Lucee抛出默认404错误，完全接管请求处理；返回false则让Lucee继续执行默认逻辑

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