如何在单页应用中用jQuery与ColdFusion处理会话超时警告？

我之前在单页应用里处理会话超时的时候，一开始用了个JavaScript函数，当时觉得这是能找到的最优解了——这个函数会在页面加载时自动触发，通过Ajax请求给服务器发信号，以此保持会话活跃。

最初的JS解决方案 #

这个方案的核心是前端定时发送保活请求，代码大概是这样的：

// 页面加载后启动会话保活定时器
window.addEventListener('load', function() {
    // 每25分钟发送一次GET请求到服务器保活接口
    const keepAliveInterval = setInterval(() => {
        fetch('/session-keep-alive.cfm', {
            method: 'GET',
            credentials: 'include' // 携带会话Cookie
        })
        .then(response => {
            if (!response.ok) {
                // 服务器返回异常，说明会话已超时，跳转到登录页
                clearInterval(keepAliveInterval);
                window.location.href = '/login.cfm';
            }
        })
        .catch(err => {
            console.error('会话保活请求失败:', err);
        });
    }, 25 * 60 * 1000); // 25分钟间隔（比服务器会话超时时间短5分钟）
});

不过用了一段时间后，我发现这个方案有不少局限：比如用户如果打开页面但长时间没有操作，前端定时器还是会一直发请求，有点浪费资源；而且如果网络不稳定，保活请求失败的话，可能会误判会话状态。

更优的ColdFusion服务器端方案 #

后来我发现了ColdFusion的onRequestStart()函数，这才是更适合的方案！这个函数会在用户刷新页面或者向服务器发送任何请求的时候自动触发，我在里面设置了时间标记来跟踪用户的最后活动时间，以此处理会话超时逻辑。

比如在我的首页（index.cfm）里的实现示例：

<cffunction name="onRequestStart" returnType="boolean" output="false">
    <cfargument name="targetPage" type="string" required="true">
    
    <!--- 定义会话超时时间：30分钟 --->
    <cfset const sessionTimeout = createTimeSpan(0, 0, 30, 0)>
    
    <!--- 检查会话是否存在最后活动标记，或者是否已超时 --->
    <cfif NOT structKeyExists(session, "lastActivity") OR (dateDiff("s", session.lastActivity, now()) > sessionTimeout.totalSeconds)>
        <!--- 会话超时，跳转到登录页面 --->
        <cflocation url="/login.cfm" addtoken="false">
        <cfreturn false>
    </cfif>
    
    <!--- 更新最后活动时间为当前时间 --->
    <cfset session.lastActivity = now()>
    
    <!--- 继续处理请求 --->
    <cfreturn true>
</cffunction>

这个方案的优势很明显：

• 完全基于服务器端触发，不需要前端额外的定时任务，节省前端资源
• 只有当用户真正有操作（刷新页面、发起业务请求）时才更新会话状态，更贴合实际用户行为
• 会话超时判断完全在服务器端，避免了前端和服务器的时间差问题

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