CherryPy参数缺失时重定向至根页面失败问题求助

问题概述 #

使用CherryPy搭建Web服务器时，当用户访问需要传入参数但未提供参数的页面，默认会返回包含“Missing parameters”提示的404错误页。期望将这类场景自动重定向至根页面（localhost:8080/），但通过自定义404错误处理函数抛出HTTPRedirect异常时，出现了“custom error page failed”的错误。

尝试过的代码 #

配置自定义404错误页：

cherrypy.config.update({'error_page.404': error_page_404})

对应的处理函数：

def error_page_404(status, message, traceback, version):
    if message.startswith('Missing parameters'):
        raise cherrypy.HTTPRedirect('/')
    else:
        raise cherrypy.HTTPError(status, message)

触发的错误 #

404 Not Found
Missing parameters: parameter1,parameter2
In addition, the custom error page failed:
cherrypy._cperror.HTTPRedirect: (['http://127.0.0.1:8080/'], 303)

解决方案 #

原因分析 #

CherryPy的错误页处理函数不支持直接抛出HTTPRedirect异常——当进入错误页处理阶段时，响应的头部已经开始构建，此时无法再通过抛出异常的方式发起重定向，必须直接构造并返回重定向的HTTP响应。

方法1：修改自定义404错误处理函数 #

直接修改响应状态码和头部，返回空内容即可触发重定向：

def error_page_404(status, message, traceback, version):
    if message.startswith('Missing parameters'):
        # 设置303重定向状态码和目标地址
        cherrypy.response.status = 303
        cherrypy.response.headers['Location'] = '/'
        return ""
    else:
        # 构建并返回默认404错误页内容
        return f"""
        <!DOCTYPE html>
        <html>
            <head><title>{status}</title></head>
            <body>
                <h1>{status}</h1>
                <p>{message}</p>
            </body>
        </html>
        """

方法2：在路由函数中提前检查参数（推荐） #

相比全局捕获404错误，在需要参数的页面处理函数中提前校验参数，能更精准地控制逻辑，避免误判其他404场景：

import cherrypy

class MyWebApp:
    @cherrypy.expose
    def index(self):
        return "根页面内容"
    
    @cherrypy.expose
    def page(self, parameter1=None, parameter2=None):
        # 检查必填参数是否存在
        if not parameter1 or not parameter2:
            raise cherrypy.HTTPRedirect('/')
        # 正常页面逻辑
        return f"参数正常：parameter1={parameter1}, parameter2={parameter2}"

if __name__ == '__main__':
    cherrypy.quickstart(MyWebApp())

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