Flask CGI部署后.htaccess配置问题修复：URL路径美化及HTTPS/WWW跳转失效解决

看起来你遇到的两个问题确实存在关联，核心是.htaccess的重写规则顺序和Flask的环境变量配置问题。下面分步骤帮你逐一修复：

一、先修复HTTPS强制与www跳转失效问题 #

你的原有配置没生效，大概率是规则顺序错误——应该先处理外部重定向（HTTPS、www跳转），再处理内部的CGI转发。另外要确保服务器启用了mod_headers模块（否则Header指令无法生效）。

更新后的HTTPS/www跳转规则：

# 强制跳转到非www域名
RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
RewriteRule ^(.*)$ https://%1/$1 [R=301,L,NE]

# 强制所有请求使用HTTPS
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L,NE]

# 强制升级不安全请求（需确保mod_headers已启用）
Header always set Content-Security-Policy "upgrade-insecure-requests;"

二、修复URL暴露cgi-bin路径的问题 #

你的原有重写规则会把请求内部转发到main.cgi，但Flask生成跳转URL时会依赖CGI环境变量SCRIPT_NAME，如果这个变量包含cgi-bin/main.cgi，就会导致跳转后的URL暴露真实路径。我们需要调整重写规则，同时给Flask传递正确的根路径环境变量。

1. 更新.htaccess的CGI重写规则 #

把这段放在HTTPS规则之后：

# 排除真实存在的文件/目录，避免静态资源被错误转发到CGI
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# 内部转发到CGI脚本，同时设置环境变量让Flask识别根路径
RewriteRule ^(.*)$ /home/user/public_html/mysite/cgi-bin/main.cgi/$1 [L,PT,E=SCRIPT_NAME:/]

这里的关键设置：

• PT（Pass-Through）标志：让Apache把重写后的路径当作URL路径处理，确保CGI脚本能正确接收请求参数
• E=SCRIPT_NAME:/：强制给Flask设置SCRIPT_NAME环境变量为根路径，这样Flask生成的跳转URL就会使用mysite.com而非包含cgi-bin/main.cgi

2. 可选：显式配置Flask的服务器名称 #

如果上面的调整后仍有问题，可以在Flask应用中显式设置SERVER_NAME，避免环境变量异常导致的路径错误：

from flask import Flask

app = Flask(__name__)
# 替换为你的实际域名
app.config['SERVER_NAME'] = 'mysite.com'

三、完整的.htaccess配置（整合所有规则） #

把所有规则按顺序整合，最终的.htaccess文件放在public_html/mysite目录下即可：

RewriteEngine On

# 1. 处理www跳转与HTTPS强制
RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
RewriteRule ^(.*)$ https://%1/$1 [R=301,L,NE]

RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L,NE]

Header always set Content-Security-Policy "upgrade-insecure-requests;"

# 2. 处理Flask CGI转发
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /home/user/public_html/mysite/cgi-bin/main.cgi/$1 [L,PT,E=SCRIPT_NAME:/]

问题根源总结 #

• HTTPS规则顺序错误：你原来把CGI转发放在了HTTPS跳转之前，导致部分请求先被转发到CGI，没触发HTTPS重定向
• 缺少SCRIPT_NAME环境变量设置：Flask默认从CGI环境中获取SCRIPT_NAME，如果这个变量是/cgi-bin/main.cgi，生成的跳转URL就会包含这段路径，通过强制设置为空根路径，就能让Flask生成干净的URL

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