# AttributeError：'Query' 对象没有属性 'filter_by'

- **ID:** `python/sqlalchemy-orm-query-attribute-error`
- **领域:** python
- **类别:** runtime_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

错误地使用 SQLAlchemy 2.0 风格的查询与旧 API。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.x | active | — | — |

## 解决方案

1. **Use session.execute() with select() in 2.0 style.** (95% 成功率)
   ```
   from sqlalchemy import select
stmt = select(User).where(User.name == 'Alice')
result = session.execute(stmt).scalars().all()
   ```
2. **Use session.query() correctly.** (90% 成功率)
   ```
   users = session.query(User).filter_by(name='Alice').all()
   ```

## 无效尝试

- **Installing older version of SQLAlchemy.** — Downgrading may break other features. (50% 失败率)
- **Using session.query().filter_by() without parentheses.** — Method call syntax still required. (70% 失败率)