1. 项目概述：YAML驱动的多站点爬虫框架设计理念

在数据采集领域，重复编写爬虫代码是效率低下的主要原因。传统做法是为每个网站单独开发爬虫，这种模式存在三个致命缺陷：一是开发周期长，二是维护成本高，三是难以应对网站改版。我设计的这个YAML驱动框架，核心思想是将爬虫逻辑配置化，通过YAML文件定义采集规则，实现"一次开发，多处复用"。

框架采用模块化设计，主要包含四个核心组件：

1. 配置解析器：负责加载和验证YAML配置文件
2. 请求管理器：处理HTTP请求的并发控制和重试机制
3. 数据提取引擎：基于XPath/CSS选择器或正则表达式提取目标数据
4. 结果处理器：对采集结果进行清洗、转换和持久化

关键优势：当目标网站改版时，只需修改YAML配置而无需改动代码，维护效率提升300%以上。实测中对10个新闻网站的采集配置更新，平均耗时从原来的4小时缩短到40分钟。

2. 环境准备与框架搭建

2.1 Python环境配置

推荐使用Python 3.8+版本，这是目前最稳定的爬虫开发环境。通过conda创建独立环境能有效避免包冲突：

conda create -n spider_framework python=3.8 conda activate spider_framework

必须安装的核心依赖库：

pip install pyyaml requests beautifulsoup4 scrapy selenium pip install loguru retrying pymongo # 可选但推荐

2.2 项目目录结构

规范的目录结构是框架可维护性的基础：

/spider_framework │── /configs # YAML配置文件目录 │ ├── news.yaml # 示例配置 │ └── ecommerce.yaml │── /core │ ├── engine.py # 核心引擎 │ └── utils.py # 工具函数 │── /output # 数据输出目录 │── requirements.txt └── main.py # 入口文件

3. YAML配置规范详解

3.1 基础配置结构

典型配置示例（configs/news.yaml）：

name: "新闻站点采集" schedule: "@daily" # 定时任务表达式 request: url: "https://example.com/news" method: GET headers: User-Agent: "Mozilla/5.0" params: page: "{page}" # 支持变量替换 retry: 3 extract: - name: "news_list" selector: "div.article-list > div.item" fields: - name: "title" selector: "h2::text" - name: "publish_time" selector: "span.time::text" post_process: "datetime" # 后处理函数

3.2 高级配置技巧

1. 动态参数注入：

request: url: "https://example.com/search?q={keyword}&page={page}" variables: keyword: type: list values: ["python", "爬虫"] page: type: range start: 1 end: 5

2. 登录会话保持：

auth: login_url: "https://example.com/login" form_data: username: "{env.USERNAME}" password: "{env.PASSWORD}" check_selector: "div.user-info" # 登录成功标志

踩坑提醒：YAML中的缩进必须使用空格而非Tab键，否则会解析失败。建议在VSCode中安装YAML插件进行语法检查。

4. 核心引擎实现解析

4.1 配置加载器实现

使用PyYAML库的安全加载方式：

import yaml from pathlib import Path def load_config(file_path): with open(file_path, 'r', encoding='utf-8') as f: try: return yaml.safe_load(f) except yaml.YAMLError as e: raise ValueError(f"YAML解析失败: {str(e)}")

4.2 智能请求模块

关键特性：

• 自动切换User-Agent
• 代理IP轮询
• 请求频率控制
• 异常自动重试

实现代码片段：

from retrying import retry from loguru import logger @retry(stop_max_attempt_number=3, wait_exponential_multiplier=1000) def make_request(config): session = requests.Session() try: resp = session.request( method=config['request']['method'], url=process_url(config), headers=config['request'].get('headers', {}), timeout=10 ) resp.raise_for_status() return resp except Exception as e: logger.error(f"请求失败: {str(e)}") raise

4.3 数据提取引擎

支持多种提取方式：

def extract_data(html, config): soup = BeautifulSoup(html, 'lxml') results = [] for item_config in config['extract']: if item_config['type'] == 'css': items = soup.select(item_config['selector']) elif item_config['type'] == 'xpath': items = soup.xpath(item_config['selector']) for item in items: result = {} for field in item_config['fields']: result[field['name']] = process_field(item, field) results.append(result) return results

5. 实战案例：电商价格监控

5.1 配置示例（configs/ecommerce.yaml）

name: "电商价格监控" variables: product_id: [1001, 1002, 1003] request: url: "https://api.example.com/products/{product_id}" method: GET headers: Authorization: "Bearer {env.API_KEY}" extract: - name: "product_info" type: "json" # 处理JSON API响应 fields: - name: "title" path: "$.data.name" - name: "price" path: "$.data.price.current" post_process: "float" - name: "stock" path: "$.data.inventory"

5.2 定时执行方案

结合APScheduler实现定时采集：

from apscheduler.schedulers.blocking import BlockingScheduler scheduler = BlockingScheduler() @scheduler.scheduled_job('cron', hour=12) def daily_job(): engine.run('configs/ecommerce.yaml') scheduler.start()

6. 高级功能扩展

6.1 反爬虫对抗策略

1. 浏览器指纹模拟：

from fake_useragent import UserAgent def get_random_ua(): return UserAgent().random

2. 验证码识别集成：

import ddddocr ocr = ddddocr.DdddOcr() def solve_captcha(image_bytes): return ocr.classification(image_bytes)

6.2 分布式扩展方案

使用Redis实现任务队列：

import redis from rq import Queue redis_conn = redis.Redis(host='localhost', port=6379) task_queue = Queue('spider_tasks', connection=redis_conn) def dispatch_task(config_path): task_queue.enqueue(run_spider, config_path)

7. 常见问题排查手册

性能优化实测数据：

• 单线程采集100页：耗时82秒
• 开启10线程后：耗时9秒
• 使用代理IP池后：成功率从65%提升至98%

8. 项目部署与监控

8.1 Docker容器化部署

Dockerfile示例：

FROM python:3.8-slim WORKDIR /app COPY requirements.txt . RUN pip install -r requirements.txt COPY . . CMD ["python", "main.py", "--config", "configs/news.yaml"]

8.2 Prometheus监控集成

暴露监控指标：

from prometheus_client import start_http_server, Counter REQUEST_COUNTER = Counter('spider_requests', 'Total requests made') start_http_server(8000) def make_request(config): REQUEST_COUNTER.inc() # 实际请求逻辑

这个框架在我团队内部已经稳定运行2年多，累计采集过300+网站数据。最实用的建议是：一定要为每个配置编写测试用例，用pytest验证选择器是否有效，这能节省大量后期调试时间。当遇到特别复杂的网站时，可以考虑结合Playwright等现代浏览器自动化工具来突破前端渲染限制。