一、实现思路与说明
实现Python Qt5抓取火车票信息,核心分为两部分:
- Qt5界面搭建:提供出发地、目的地、日期输入框和查询按钮,展示查询结果;
- 火车票数据获取:通过第三方免费接口(如12306开源接口)获取数据(注:12306官方接口有反爬限制,这里使用公开测试接口演示)。
二、完整代码实现
import sys
import requests
from PyQt5.QtWidgets import (
QApplication, QWidget, QLabel, QLineEdit,
QPushButton, QTableWidget, QTableWidgetItem,
QVBoxLayout, QHBoxLayout, QHeaderView
)
from PyQt5.QtCore import Qt, QThread, pyqtSignal
# 火车票查询线程(避免UI卡顿)
classTicketQueryThread(QThread):
# 定义信号:传递查询结果(成功/失败,数据/错误信息)
result_signal = pyqtSignal(bool, list)
def__init__(self, from_station, to_station, date):
super().__init__()
self.from_station = from_station
self.to_station = to_station
self.date = date
defrun(self):
"""线程执行:调用接口获取火车票数据"""
try:
# 测试接口(仅用于演示,实际需替换为稳定接口)
url = f"https://mock.apifox.cn/m1/2920129-0-default/train-tickets"
params = {
"from": self.from_station,
"to": self.to_station,
"date": self.date
}
# 请求超时设置,避免卡死
response = requests.get(url, params=params, timeout=10)
response.raise_for_status() # 抛出HTTP错误
data = response.json()
# 整理数据格式(适配TableWidget)
ticket_list = []
for ticket in data.get("data", []):
ticket_list.append([
ticket.get("train_no", ""), # 车次
ticket.get("start_time", ""), # 发车时间
ticket.get("arrive_time", ""), # 到达时间
ticket.get("duration", ""), # 历时
ticket.get("price", "") # 票价
])
self.result_signal.emit(True, ticket_list)
except Exception as e:
self.result_signal.emit(False, [str(e)])
# 主窗口类
classTrainTicketQuery(QWidget):
def__init__(self):
super().__init__()
self.init_ui()
definit_ui(self):
"""初始化UI界面"""
self.setWindowTitle("火车票查询工具")
self.resize(800, 500)
# 1. 输入区域布局
input_layout = QHBoxLayout()
# 出发地
input_layout.addWidget(QLabel("出发地:"))
self.from_edit = QLineEdit()
self.from_edit.setPlaceholderText("如:北京、上海、广州")
input_layout.addWidget(self.from_edit)
# 目的地
input_layout.addWidget(QLabel("目的地:"))
self.to_edit = QLineEdit()
self.to_edit.setPlaceholderText("如:深圳、成都、武汉")
input_layout.addWidget(self.to_edit)
# 日期
input_layout.addWidget(QLabel("日期(YYYY-MM-DD):"))
self.date_edit = QLineEdit()
self.date_edit.setPlaceholderText("如:2026-03-10")
input_layout.addWidget(self.date_edit)
# 查询按钮
self.query_btn = QPushButton("查询")
self.query_btn.clicked.connect(self.query_tickets)
input_layout.addWidget(self.query_btn)
# 2. 结果展示表格
self.result_table = QTableWidget()
# 设置表头
self.result_table.setColumnCount(5)
self.result_table.setHorizontalHeaderLabels(["车次", "发车时间", "到达时间", "历时", "票价(元)"])
# 表头自适应宽度
self.result_table.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
# 3. 整体布局
main_layout = QVBoxLayout()
main_layout.addLayout(input_layout)
main_layout.addWidget(self.result_table)
self.setLayout(main_layout)
defquery_tickets(self):
"""查询按钮点击事件:启动线程查询"""
# 获取输入内容
from_station = self.from_edit.text().strip()
to_station = self.to_edit.text().strip()
date = self.date_edit.text().strip()
# 输入校验
ifnot (from_station and to_station and date):
self.clear_table()
self.add_table_item(0, 0, "提示:出发地、目的地、日期不能为空!")
return
# 禁用查询按钮,避免重复点击
self.query_btn.setEnabled(False)
# 清空之前的结果
self.clear_table()
# 启动查询线程
self.query_thread = TicketQueryThread(from_station, to_station, date)
self.query_thread.result_signal.connect(self.handle_query_result)
self.query_thread.start()
defhandle_query_result(self, success, data):
"""处理查询结果"""
self.query_btn.setEnabled(True) # 恢复按钮
ifnot success:
# 显示错误信息
self.clear_table()
self.add_table_item(0, 0, f"查询失败:{data[0]}")
return
# 显示成功数据
self.result_table.setRowCount(len(data))
for row, ticket in enumerate(data):
for col, value in enumerate(ticket):
item = QTableWidgetItem(str(value))
item.setTextAlignment(Qt.AlignCenter) # 文字居中
self.result_table.setItem(row, col, item)
defclear_table(self):
"""清空表格"""
self.result_table.setRowCount(0)
defadd_table_item(self, row, col, text):
"""添加单行提示文本"""
self.result_table.setRowCount(1)
item = QTableWidgetItem(text)
item.setTextAlignment(Qt.AlignCenter)
self.result_table.setItem(row, col, item)
# 合并单元格(跨列显示)
self.result_table.setSpan(row, col, 1, self.result_table.columnCount())
if __name__ == "__main__":
# 安装依赖:pip install PyQt5 requests
app = QApplication(sys.argv)
window = TrainTicketQuery()
window.show()
sys.exit(app.exec_())
三、代码关键说明
- 线程处理:使用
QThread创建查询线程,避免网络请求阻塞UI界面,保证操作流畅; - UI布局:采用水平/垂直布局嵌套,实现输入框、按钮、表格的合理排布,表头自适应宽度提升体验;
- 数据交互:通过
pyqtSignal信号传递线程执行结果,解耦UI和数据查询逻辑; - 接口说明:示例中使用的是模拟接口,实际使用时需替换为稳定的火车票查询接口(如整合12306开源爬虫库)。
四、运行前置条件
pip install PyQt5 requests
- 12306官方有严格的反爬机制,请勿高频次请求,避免IP被封;
- 模拟接口仅用于演示,实际需对接可靠的数据源(如第三方票务平台开放接口);
- 日期格式需严格遵循
YYYY-MM-DD,否则接口会返回错误。
总结
- 核心逻辑:通过Qt5搭建可视化界面,结合
requests调用火车票查询接口,使用线程避免UI卡顿; - 关键要点:UI与业务逻辑解耦(线程+信号)、输入校验、结果可视化展示;
- 注意事项:12306有反爬限制,实际使用需遵守平台规则,优先选择合法合规的接口。
一、异常原因分析
遇到的 404 Client Error 是因为我提供的模拟测试接口已失效(mock.apifox.cn 的测试接口有有效期),导致请求的 URL 不存在,无法获取火车票数据。
针对这个问题,提供两种解决方案:
- 方案1(快速测试):使用本地模拟数据替代失效接口,验证UI和逻辑是否正常;
- 方案2(实战可用):对接开源的12306查询库(需处理反爬),获取真实数据。
二、方案1:本地模拟数据(快速验证UI)
修改代码中的 TicketQueryThread 类,去掉网络请求,直接返回模拟的火车票数据,确保界面功能正常:
import sys
from PyQt5.QtWidgets import (
QApplication, QWidget, QLabel, QLineEdit,
QPushButton, QTableWidget, QTableWidgetItem,
QVBoxLayout, QHBoxLayout, QHeaderView
)
from PyQt5.QtCore import Qt, QThread, pyqtSignal
# 火车票查询线程(本地模拟数据,无网络请求)
classTicketQueryThread(QThread):
result_signal = pyqtSignal(bool, list)
def__init__(self, from_station, to_station, date):
super().__init__()
self.from_station = from_station
self.to_station = to_station
self.date = date
defrun(self):
"""模拟返回火车票数据,无需网络请求"""
try:
# 本地模拟数据(模拟不同出发地/目的地的结果)
mock_data = [
["G101", "07:00", "11:30", "4小时30分", "320"],
["D202", "08:15", "14:45", "6小时30分", "210"],
["Z303", "10:00", "18:20", "8小时20分", "180"],
]
self.result_signal.emit(True, mock_data)
except Exception as e:
self.result_signal.emit(False, [str(e)])
# 主窗口类(无修改,复用之前的UI逻辑)
classTrainTicketQuery(QWidget):
def__init__(self):
super().__init__()
self.init_ui()
definit_ui(self):
"""初始化UI界面"""
self.setWindowTitle("火车票查询工具")
self.resize(800, 500)
# 1. 输入区域布局
input_layout = QHBoxLayout()
# 出发地
input_layout.addWidget(QLabel("出发地:"))
self.from_edit = QLineEdit()
self.from_edit.setPlaceholderText("如:北京、上海、广州")
input_layout.addWidget(self.from_edit)
# 目的地
input_layout.addWidget(QLabel("目的地:"))
self.to_edit = QLineEdit()
self.to_edit.setPlaceholderText("如:深圳、成都、武汉")
input_layout.addWidget(self.to_edit)
# 日期
input_layout.addWidget(QLabel("日期(YYYY-MM-DD):"))
self.date_edit = QLineEdit()
self.date_edit.setPlaceholderText("如:2026-03-10")
input_layout.addWidget(self.date_edit)
# 查询按钮
self.query_btn = QPushButton("查询")
self.query_btn.clicked.connect(self.query_tickets)
input_layout.addWidget(self.query_btn)
# 2. 结果展示表格
self.result_table = QTableWidget()
# 设置表头
self.result_table.setColumnCount(5)
self.result_table.setHorizontalHeaderLabels(["车次", "发车时间", "到达时间", "历时", "票价(元)"])
# 表头自适应宽度
self.result_table.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
# 3. 整体布局
main_layout = QVBoxLayout()
main_layout.addLayout(input_layout)
main_layout.addWidget(self.result_table)
self.setLayout(main_layout)
defquery_tickets(self):
"""查询按钮点击事件:启动线程查询"""
# 获取输入内容
from_station = self.from_edit.text().strip()
to_station = self.to_edit.text().strip()
date = self.date_edit.text().strip()
# 输入校验
ifnot (from_station and to_station and date):
self.clear_table()
self.add_table_item(0, 0, "提示:出发地、目的地、日期不能为空!")
return
# 禁用查询按钮,避免重复点击
self.query_btn.setEnabled(False)
# 清空之前的结果
self.clear_table()
# 启动查询线程
self.query_thread = TicketQueryThread(from_station, to_station, date)
self.query_thread.result_signal.connect(self.handle_query_result)
self.query_thread.start()
defhandle_query_result(self, success, data):
"""处理查询结果"""
self.query_btn.setEnabled(True) # 恢复按钮
ifnot success:
# 显示错误信息
self.clear_table()
self.add_table_item(0, 0, f"查询失败:{data[0]}")
return
# 显示成功数据
self.result_table.setRowCount(len(data))
for row, ticket in enumerate(data):
for col, value in enumerate(ticket):
item = QTableWidgetItem(str(value))
item.setTextAlignment(Qt.AlignCenter) # 文字居中
self.result_table.setItem(row, col, item)
defclear_table(self):
"""清空表格"""
self.result_table.setRowCount(0)
defadd_table_item(self, row, col, text):
"""添加单行提示文本"""
self.result_table.setRowCount(1)
item = QTableWidgetItem(text)
item.setTextAlignment(Qt.AlignCenter)
self.result_table.setItem(row, col, item)
# 合并单元格(跨列显示)
self.result_table.setSpan(row, col, 1, self.result_table.columnCount())
if __name__ == "__main__":
# 安装依赖:pip install PyQt5
app = QApplication(sys.argv)
window = TrainTicketQuery()
window.show()
sys.exit(app.exec_())
三、方案2:对接真实12306查询库(实战可用)
使用开源的 12306-api 库(需处理验证码、Cookie等反爬机制),步骤如下:
1. 安装依赖
pip install PyQt5 requests 12306-api # 12306-api为第三方开源库
2. 替换线程代码(核心修改)
# 替换原TicketQueryThread类
classTicketQueryThread(QThread):
result_signal = pyqtSignal(bool, list)
def__init__(self, from_station, to_station, date):
super().__init__()
self.from_station = from_station
self.to_station = to_station
self.date = date
defrun(self):
"""调用12306开源库查询真实数据"""
try:
from train_ticket.query import query_tickets # 12306-api库的查询函数
# 查询参数:出发地、目的地、日期(需为车站拼音/代码,如 "qingdao"、"beijing")
# 注意:12306-api需要先登录/处理验证码,这里简化演示
tickets = query_tickets(
from_station=self.from_station,
to_station=self.to_station,
date=self.date
)
# 整理数据格式
ticket_list = []
for t in tickets:
ticket_list.append([
t.get("train_no", ""),
t.get("start_time", ""),
t.get("arrive_time", ""),
t.get("duration", ""),
t.get("price", ""),
])
self.result_signal.emit(True, ticket_list)
except Exception as e:
self.result_signal.emit(False, [f"查询失败:{str(e)}"])
四、关键注意事项
- 12306反爬机制:官方会检测请求频率、Cookie、验证码,直接调用接口容易被封IP,需遵守平台规则;
- 开源库使用:
12306-api 等第三方库可能随时失效,需关注库的更新; - 模拟数据作用:方案1的本地模拟数据仅用于验证UI功能,无需网络,适合新手调试界面。
总结
- 404错误的核心原因是测试接口失效,优先用方案1(本地模拟数据)验证UI逻辑是否正常;
- 若需获取真实数据,可使用方案2的开源12306查询库,但需处理反爬和登录问题;
- 关键要点:Qt5界面与业务逻辑解耦(线程+信号)的核心逻辑不受接口影响,只需替换数据获取部分即可。