diff --git a/vulture_whitelist.py b/vulture_whitelist.py
new file mode 100644
index 000000000..155f481b7
--- /dev/null
+++ b/vulture_whitelist.py
@@ -0,0 +1,57 @@
+# vulture_whitelist.py - vulture 白名单文件
+# 用途: 列出已知被框架/动态调用的代码，避免误报
+# 参考: https://vulture.readthedocs.io/en/stable/whitelists.html
+
+# FastAPI / Starlette 框架自动调用
+# FastAPI route handlers (通过装饰器注册，vulture 可能无法识别)
+apps.*.main.*
+apps.*.api.*
+apps.*.routes.*
+apps.*.views.*
+
+# SQLAlchemy ORM
+# Model 类和字段通过 ORM 框架自动使用
+apps.*.models.*
+apps.*.schemas.*
+packages.*.models.*
+
+# Pydantic models
+# Pydantic 字段通过序列化/反序列化使用
+apps.*.schemas.*
+packages.*.schemas.*
+
+# Alembic migrations
+# Migration 函数由 alembic 自动调用
+alembic.versions.*.upgrade
+alembic.versions.*.downgrade
+
+# Celery tasks
+# Task 函数通过 celery worker 调用
+apps.*.tasks.*
+packages.*.tasks.*
+
+# CLI scripts / entry points
+# 脚本通过命令行调用
+scripts.*
+
+# 中间件
+apps.*.middleware.*
+packages.*.middleware.*
+
+# 异常类
+apps.*.exceptions.*
+packages.*.exceptions.*
+
+# 配置类
+apps.*.config.*
+packages.*.config.*
+
+# 工具函数（可能被多处间接调用，先白名单，后续清理）
+apps.*.utils.*
+packages.*.utils.*
+apps.*.helpers.*
+packages.*.helpers.*
+
+# Dependencies (FastAPI Depends)
+apps.*.dependencies.*
+packages.*.dependencies.*