使用 Python 快速搭建简易 Web 服务

山海之间

发布时间：2026-10-12 | 4人浏览过

原创

本文介绍如何利用 Python 及 web.py 库编写并运行一个基础 Web 服务。通过创建路由映射、定义处理类与 GET 方法，配合默认端口启动脚本，即可在本地快速返回文本响应。附带完整代码、访问地址核对及常见端口冲突排错步骤，帮助初学者掌握最基础的 Web 应用逻辑。

目标与运行原理

构建简易 Python Web 程序的核心在于建立“请求路径”与“响应函数”的映射关系。当用户通过浏览器发起 HTTP 请求时，框架会匹配预设的路由规则，调用对应的类方法并返回纯文本或页面数据。本方案采用轻量级 web.py 库，无需复杂配置即可在 MAC 或 Linux 环境下快速验证 Web 服务逻辑。

环境准备

确保系统已安装 Python 解释器（推荐 3.x 版本）。由于本示例依赖非内置的网络框架，请先在终端执行包管理命令安装依赖：

打开终端，进入项目存放目录。
执行 pip install web.py 下载官方维护的稳定版库文件。

第1步：编写路由映射与响应类

在工作目录下新建文件 hello.py，并使用编辑器写入以下初始化与路由配置代码。该段代码定义了 URL 匹配规则以及具体的响应逻辑：

import web

# 配置路由映射：将 "/Service/hello" 路径绑定到 hello 类
urls = ("/Service/hello", "hello")
app = web.application(urls, globals())

class hello:
    # GET 方法处理用户的普通请求
    def GET(self):
        return "Hello, world!"

if __name__ == "__main__":
    # 启动内嵌 HTTP 服务器
    app.run()

核心参数说明：web.application 接收元组格式的路由表；class hello 中的 def GET(self) 专用于响应前端或浏览器的 GET 请求；返回值将直接作为 HTTP 响应体传输给客户端。

第2步：启动内嵌 HTTP 服务器

保存文件后，回到终端执行启动命令。web.py 内置了简易服务器，默认会自动监听本机所有网络接口的 8080 端口：

python hello.py

执行成功后，终端通常会输出类似 http://0.0.0.0:8080/ 的监听地址提示。此时程序已进入阻塞运行状态，保持终端窗口开启即可。

第3步：验证本地访问路径

打开系统自带或第三方浏览器，在地址栏输入完整的本地回环地址进行请求测试：

http://localhost:8080/Service/hello

若配置无误，浏览器页面将直接显示 Hello, world! 字符串。同时，启动代码的终端窗口会实时打印访问日志，包含 IP、时间戳及关键的状态码信息：

127.0.0.1:xxxxx - - [DD/Mon/YYYY HH:MM:SS] "HTTP/1.1 GET /Service/hello" - 200 OK

其中末尾的 200 OK 代表服务器已成功接收请求并返回有效数据，标志着简易 Web 服务搭建完成。

排错与注意事项

端口被占用：若启动时终端报错提示 Address already in use，说明 8080 端口已被其他软件占用。可修改源码 app.run() 调用处传入指定端口，例如 app.run(port=8081) 后重新启动。
路由地址不匹配：务必核对浏览器输入的 Path 必须严格匹配代码内的 "/Service/hello"。若直接访问根路径 / 或未定义的路径，框架通常会返回 404 或 405 状态码。
静态资源托管：本示例仅演示文本接口返回。若后续需挂载 CSS、JS 或图片，需在工程目录按规范创建 static/ 文件夹并在路由表中增加对应映射规则。

简要总结

借助 Python 生态中成熟的轻量级框架，仅需数十行代码即可完成从路由定义、逻辑编写到服务监听的完整闭环。上述流程验证了 B/S 架构下请求与响应的标准交互模式，可作为进一步接入数据库、模板引擎或 API 网关的基础跳板。以上就是使用 Python 快速搭建简易 Web 服务的详细内容，更多关于 Python Web 开发的基础资料请关注本站其它相关文章！