# 路由构建错误：无法为端点 'index' 构建包含 '_external' 的 URL。是否忘记指定值 ['host']？

- **ID:** `python/flask-url-for-external-required`
- **领域:** python
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

Flask 的 url_for 函数在生成外部 URL 时缺少 host 参数

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.9 | active | — | — |
| 3.10 | active | — | — |

## 解决方案

1. **在应用配置中设置 SERVER_NAME** (95% 成功率)
   ```
   app.config['SERVER_NAME'] = 'example.com'
   ```
2. **显式传递 host 参数** (90% 成功率)
   ```
   url_for('index', _external=True, host='example.com')
   ```

## 无效尝试

- **移除 _external 参数** — 生成的 URL 可能不完整 (60% 失败率)
- **硬编码主机名** — 不灵活，不同环境需要修改 (70% 失败率)