如何解决 Namecheap 共享主机上 Flask 动态路由 404 问题

在 Namecheap 共享主机部署 Flask 应用时，根路径 / 可正常访问，但带变量的动态路由（如 //）返回 404，根本原因是其默认启用的 Website Builder 的 .htaccess 重写规则劫持了所有请求。

如果你在 Namecheap 的共享主机上部署 Flask 应用，很可能会遇到一个让人头疼的坑：根路径 / 访问得好好的，可一旦换成带变量的动态路由，比如 //，直接给你返回 404 页面。别急着怀疑代码写错了——问题十有八九出在 Namecheap 默认开启的 Website Builder 规则上，它悄悄在 .htaccess 里埋了一行重写，把本该交给 Flask 的请求全部截胡了。

Flask 在共享主机上跑，依赖的是 Apache + mod_wsgi（或者通过 passenger_wsgi.py 来驱动）。但 Namecheap 为了照顾使用“Website Builder”功能的用户，默认会在 public_html/.htaccess 里自动生成一条强制重写规则，内容长这样：

RewriteRule ^(.*)$ ncsitebuilder/$1 [L,QSA]

这条规则的意思很简单粗暴：所有 HTTP 请求，不管路径是什么，一律重定向到 ncsitebuilder/ 子目录。这样一来，Flask 应用根本收不到 /username/ 这类动态路由请求——Apache 直接把请求扔给了 Website Builder，压根没到 WSGI 应用那一步。所以返回 404 是必然的，而且你在 Flask 的应用日志里看不到任何记录，因为请求根本没进到你的代码里。

解决方案其实很简单：手动编辑 public_html/.htaccess 文件，把上面那行 RewriteRule 注释掉或者删掉即可：

# RewriteRule ^(.*)$ ncsitebuilder/$1 [L,QSA]

这里有几个注意事项，值得留意：

• 这个操作不会影响 Flask 应用本身，只是解除了 Website Builder 对请求流的拦截；
• 如果你确实用 Website Builder 搭建了其他页面，禁用这条规则后，那些页面就访问不了了——两者是互斥的。建议：如果纯粹是托管 Flask 应用，干脆在 cPanel 里彻底停用 Website Builder，省得后续再出冲突；
• 修改完 .htaccess 后不需要重启服务，Apache 会自动生效，部分环境可能等 1-2 分钟缓存刷新就能看到效果；
• 确保你的 passenger_wsgi.py（或 wsgi.py）正确指向 Flask 实例（比如 application = app），文件权限设为 644；
• 路由末尾的斜杠要前后一致：如果定义的是 @app.route("//")，那访问时必须带上尾部斜杠（比如 /alice/），否则 /alice 会返回 404。如果需要兼容两种写法，可以加上 strict_slashes=False：

@app.route("/", strict_slashes=False)
def say_hello(name):
    return f"Hello {name}!"

验证步骤也很清晰：

1. 通过 FTP 或 cPanel 文件管理器打开 public_html/.htaccess；
2. 找到并注释掉 RewriteRule ^(.*)$ ncsitebuilder/$1 [L,QSA]；
3. 保存文件；
4. 访问 https://yoursite.com/test/ —— 应该返回 "Hello test!"。

至此，Flask 的完整路由机制（包括变量捕获、HTTP 方法区分、URL 参数解析等）就可以在 Namecheap 共享主机上正常工作了。核心原则始终是那一句：确保 Web 服务器将请求准确传递给 WSGI 应用，而不是被中间层的规则拦腰截断。