“)
else:
print(“
用户不存在
“)
except Exception as e:
print(f”
数据库错误: {e}
“)
finally:
if ‘conn’ in locals():
conn.close()
3. 赋予脚本执行权限：`chmod +x /var/www/cgi-bin/query_db.py`。
<h3>第三步：创建前端HTML表单</h3>
在Web根目录（如`/var/www/html/`）创建`index.html`，用于向CGI脚本发送请求。
```html
<!DOCTYPE html>
<html>
<head>CGI数据库查询示例</title>
</head>
<body>
<h2>查询用户信息</h2>
<!-- action指向CGI脚本的路径 -->
<form action="/cgi-bin/query_db.py" method="GET">
<label for="username">用户名：</label>
<input type="text" id="username" name="username">
<button type="submit">查询</button>
</form>
</body>
</html>常见技术选型与对比分析
虽然CGI是经典方案,但随着技术发展，出现了更多替代方案，了解它们的差异有助于做出正确选择。
CGI vs. FastCGI
传统的CGI为每个HTTP请求启动一个新的进程,如果同时有100个用户访问，服务器就要启动100个Python进程，这会消耗大量内存和CPU资源，导致性能瓶颈。
- CGI：请求-响应-销毁进程，适合低流量、简单的场景。
- FastCGI：保持进程常驻内存，复用连接，性能提升显著，是Nginx+PHP等主流架构的基础。
对于高并发场景,业内共识认为应优先选择FastCGI或现代WSGI框架（如Gunicorn、uWSGI），而非原生CGI。
CGI vs. 现代API架构
在现代Web开发中,前后端分离已成为主流，HTML页面通过JavaScript（AJAX/Fetch）直接调用RESTful API，而不是通过CGI生成HTML。
- CGI模式：服务器返回完整的HTML页面，浏览器重新加载整个页面，用户体验较差，网络传输冗余大。
- API模式：服务器返回JSON数据，前端JavaScript动态更新DOM，用户体验流畅，支持单页应用（SPA）。
在某些遗留系统维护或简单的内部工具开发中,CGI因其部署简单、无需复杂服务器配置，仍具有一定的实用价值。
常见问题与解决方案
为什么CGI脚本返回500内部服务器错误？
这是最常见的问题,通常由以下原因引起：
- 权限问题：确保脚本文件具有执行权限（
chmod +x），且Web服务器用户（如www-data）有读取权限。 - Shebang错误：第一行必须正确指向Python解释器路径，如
#!/usr/bin/env python3。 - 编码问题：确保脚本文件保存为UTF-8无BOM格式，避免中文乱码导致解析失败。
- 日志排查：查看Apache的错误日志（通常位于
/var/log/apache2/error.log），里面会详细记录错误原因。
如何防止SQL注入攻击？
在CGI脚本中操作数据库时,严禁使用字符串拼接构造SQL语句。
- 错误做法：
cursor.execute("SELECT FROM users WHERE name = '" + name + "'") - 正确做法：使用参数化查询，如
cursor.execute("SELECT FROM users WHERE name = ?", (name,))。
参数化查询会将用户输入视为数据而非代码,从根本上杜绝SQL注入风险。
CGI在2026年还有必要学习吗？
虽然新项目很少直接使用原生CGI,但理解其原理对开发者依然重要。
- 理解Web本质：CGI展示了HTTP请求与后端处理的基本交互模式，有助于理解现代框架（如Django、Flask）的工作原理。
- 维护遗留系统：许多政府机构、银行内部系统仍运行在CGI架构上，维护这些系统需要相关技能。
- 嵌入式开发：在资源受限的物联网设备中，轻量级的CGI脚本仍是实现Web管理界面的有效手段。
HTML通过CGI打开数据库是一个经典的技术组合,尽管在现代大型应用中已被更高效的架构取代，但其核心思想前后端分离、服务器端处理依然是Web开发的基石，掌握这一流程，不仅能解决具体的技术难题，更能深入理解Web系统的运作机制，对于初学者而言，亲手搭建一个CGI环境，是通往全栈开发的重要一步。
首发原创文章，作者：世雄 - 原生数据库架构专家，如若转载，请注明出处：https://idctop.com/article/316892.html
