Windows下配置XAMPP运行Python CGI脚本遇阻求助

阿华AIGC实验室

2026-5-27

排查CGI脚本无法运行的问题 + 更优替代方案

首先咱们先搞定Hello World的CGI基础问题，之后再处理Selenium的自动化部分。

一、先排查CGI配置和脚本本身的问题

1. 检查Apache的核心配置

打开你的httpd.conf，确认以下几点：

有没有添加AddHandler cgi-script .py，确保.py文件被识别为CGI脚本；
找到cgi-bin目录的配置块，确保里面包含Options +ExecCGI（允许执行CGI脚本），同时权限配置要正确，比如：
```
<Directory "C:/xampp/cgi-bin">
    AllowOverride None
    Options +ExecCGI
    Order allow,deny
    Allow from all
</Directory>
```
改完配置后一定要重启Apache服务，不然配置不会生效。

2. 修正脚本的shebang行（Windows环境重点）

你写的#!/usr/local/bin/Python27/python是类Unix系统的路径，Windows下XAMPP的Python路径大概率不是这个。虽然Windows下shebang行不是强制要求，但写错了可能会导致Apache找不到解释器。
找到你Python2.7的实际安装路径（比如C:\Python27\python.exe），把shebang改成：

#!C:/Python27/python.exe

注意要用正斜杠/，不要用Windows的反斜杠\。

3. 检查脚本权限和换行符

Windows下，确保Apache的运行用户（一般是SYSTEM或者你当前的登录用户）有对myscript.py的读取和执行权限；
脚本的换行符尽量用LF（Unix格式），如果是CRLF（Windows格式），有些Apache配置可能会报错，你可以用编辑器（比如Notepad++）转换一下格式。

4. 先在命令行测试脚本

打开命令提示符，运行：

python C:\xampp\cgi-bin\myscript.py

如果能输出以下内容，说明脚本本身没问题：

Content-Type: text/html

hello world

如果命令行报错，先解决这个问题（比如Python路径不对、语法错误），再去尝试浏览器访问。

5. 查看Apache错误日志

这是排查问题最关键的一步！XAMPP的Apache错误日志在C:\xampp\apache\logs\error.log，打开看看有没有具体的错误信息，比如：

“找不到Python解释器”：说明shebang路径错误；
“权限不足”：说明脚本或目录权限有问题；
“CGI脚本输出格式错误”：说明你没正确输出Content-Type头。

二、当CGI正常后，运行Selenium的注意事项

如果CGI能正常跑Hello World了，接下来要注意Selenium的几个关键点：

浏览器驱动路径：要把ChromeDriver（或Firefox的GeckoDriver）的路径加到Apache运行用户的系统PATH里，或者在脚本里直接写绝对路径，比如：
```
driver = webdriver.Chrome(executable_path='C:/path/to/chromedriver.exe')
```

无头模式运行：因为CGI是在Apache的后台进程里运行，浏览器不能弹出窗口，必须用无头模式，以Chrome为例：

from selenium.webdriver.chrome.options import Options
chrome_options = Options()
chrome_options.add_argument('--headless')
chrome_options.add_argument('--disable-gpu')
driver = webdriver.Chrome(options=chrome_options)

清理进程：脚本结束后一定要调用driver.quit()，不然会残留大量浏览器进程，拖垮系统。

三、更适合新手的替代方案：用Flask框架代替CGI

CGI确实比较老旧，配置繁琐，对于新手来说，用轻量级的Web框架Flask会简单很多，不需要折腾Apache的CGI配置，步骤如下：

1. 安装适配Python2.7的Flask

因为Python2.7已经停止维护，新版本Flask不支持它，所以要安装旧版本：

pip install flask==0.12.5

2. 写一个简单的Flask应用（带按钮触发脚本）

创建一个app.py文件，内容如下：

from flask import Flask, render_template_string
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

app = Flask(__name__)

# 首页：显示一个触发按钮
@app.route('/')
def index():
    return render_template_string('''
        <h3>点击按钮运行自动化脚本</h3>
        <form method="post" action="/run_auto">
            <button type="submit">开始执行</button>
        </form>
    ''')

# 处理按钮提交，运行Selenium脚本
@app.route('/run_auto', methods=['POST'])
def run_auto():
    # 配置无头Chrome
    chrome_options = Options()
    chrome_options.add_argument('--headless')
    chrome_options.add_argument('--disable-gpu')
    driver = webdriver.Chrome(executable_path='C:/path/to/chromedriver.exe')
    
    # 这里写你的自动化逻辑，比如打开网页获取标题
    driver.get('https://example.com')
    page_title = driver.title
    driver.quit()
    
    return f"自动化脚本执行完成！页面标题：{page_title}"

if __name__ == '__main__':
    app.run(port=31337, debug=True)