ColdFusion 2016自定义错误页面配置：处理TemplateNotFound异常

看起来你已经试了几种方法但没搞定TemplateNotFound的自定义错误页面，而且不想影响服务器上的其他应用，完全理解你的需求。下面针对你用application.cfm的场景，给出两种可行的方案：

方案一：在application.cfm中使用<cferror>捕获特定异常 #

TemplateNotFound对应的ColdFusion异常类是coldfusion.runtime.MissingTemplateException，你可以在application.cfm里通过<cferror>标签精准捕获这个异常，而且只会作用于当前应用，不会影响服务器上的其他项目。

把这段代码添加到你的application.cfm中：

<!--- 捕获TemplateNotFound异常，跳转到自定义错误页面 --->
<cferror type="exception"
         exception="coldfusion.runtime.MissingTemplateException"
         template="/your-app-path/custom404.cfm"
         mailto="your-support-email@example.com">

关键说明： #

• type="exception"：表示我们要捕获特定类型的异常，而非通用的请求错误。
• exception="coldfusion.runtime.MissingTemplateException"：指定要捕获的就是模板找不到的异常。
• template：替换成你实际的自定义错误页面路径，确保路径是相对于应用根目录的正确路径。

在你的自定义错误页面（比如custom404.cfm）里，还可以获取异常的详细信息，比如缺失的模板路径：

<h1>抱歉，页面未找到</h1>
<p>你访问的页面：<strong>#error.exception.getTemplateName()#</strong> 不存在，请检查网址是否正确。</p>

方案二：切换到application.cfc使用onMissingTemplate方法 #

你之前尝试的onMissingTemplate其实是application.cfc特有的生命周期方法，在application.cfm里是无法生效的。如果可以切换到application.cfc（这也是ColdFusion推荐的应用管理方式），这个方法会更灵活：

创建或替换为application.cfc，代码示例：

component {
    // 应用基本配置
    this.name = "YourUniqueAppName";
    this.applicationTimeout = createTimeSpan(0, 1, 0, 0); // 1小时超时

    // 处理模板找不到的情况
    function onMissingTemplate(targetPage) {
        // 重定向到自定义错误页面，传递缺失的页面路径
        location(url="/your-app-path/custom404.cfm?missingPage=#encodeForURL(targetPage)#", addToken=false);
        return false; // 返回false阻止ColdFusion显示默认错误页面
    }
}

然后在custom404.cfm里可以通过URL参数获取缺失的页面：

<h1>页面未找到</h1>
<p>请求的页面：<strong>#url.missingPage#</strong> 不存在。</p>

为什么之前的onMissingTemplate没效果？ #

因为onMissingTemplate是application.cfc独有的方法，application.cfm不支持这个生命周期钩子，所以你之前的尝试自然不会生效。

注意事项 #

• 确保自定义错误页面的路径正确，避免出现错误页面本身找不到的情况。
• 两种方案都只会作用于当前应用，不会影响服务器上的其他ColdFusion应用，完全符合你的需求。

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