read_sql本身不引入SQL注入漏洞，但拼接用户输入的SQL字符串会引发风险；占位符语法由DBAPI驱动决定，表名/列名/排序字段不可参数化，须用白名单校验；con需为SQLAlchemy Engine实例才能可靠支持params；to_sql无参数化机制，表名列名须严格清洗。
read_sql 本身不引入注入漏洞，但你传给它的 SQL 字符串如果拼接了用户输入，就会立刻中招。 它只是把 SQL 和 params 原样交给底层驱动执行，防护责任完全在你构造 SQL 的方式上。
占位符必须匹配数据库驱动语法，混用直接报错
SQL 占位符不是 Pandas 定义的，而是由你用的 DBAPI 驱动决定的：sqlite3 和 pymysql 用 ?；psycopg2（PostgreSQL）用 %s；SQLAlchemy + text() 支持 :name 命名式。写错会触发类似 TypeError: not all arguments converted during string formatting 的错误。
- SQLite / MySQL：写成
"SELECT * FROM logs WHERE level = ? AND ts > ?"，params传元组("ERROR", "2026-01-01") - PostgreSQL：写成
"SELECT * FROM events WHERE category = %s"，params传元组或列表["login"] - SQL Server 或通用 SQLAlchemy 场景：用
text()包裹，写成text("EXEC dbo.GetUsers @status = :status")，params传字典{"status": "active"}
表名、列名、ORDER BY 字段不能参数化，白名单是唯一出路
下面这行代码一定失败：pd.read_sql("SELECT * FROM ?", con, params=["users"])。SQL 标准禁止用占位符代入标识符（identifier），数据库会直接报语法错误。
- 排序字段动态化：只允许
if sort_col in ["created_at", "score", "status"]:，再拼进 SQL；禁止f"ORDER BY {user_input}" - 表名映射：定义
table_map = {"log": "app_logs_v2", "alert": "monitoring_alerts"}，用键做输入校验，值做真实表名 - 列名清洗：若需用户选列，先
df.columns.tolist()获取合法列名列表，再判断输入是否在其中
con 参数类型错误会导致 params 被忽略
如果你传的是原始连接（如 sqlite3.Connection 或 psycopg2.connection），params 可能被静默忽略——因为部分底层驱动不支持统一的参数透传接口。真正能稳定支持 params 的是 SQLAlchemy Engine 实例。
- 错误写法：
conn = sqlite3.connect("db.db"); pd.read_sql("SELECT * FROM t WHERE id = ?", conn, params=(123,))—— 在某些环境里params不生效 - 正确写法：
engine = create_engine("sqlite:///db.db"); pd.read_sql("SELECT * FROM t WHERE id = ?", engine, params=(123,)) - MySQL/PostgreSQL 必须装对应驱动：
pymysql或psycopg2，否则create_engine初始化就失败
to_sql 没有参数化接口，别试图“改造”它防注入
to_sql 的设计目标是写入已结构化的 DataFrame，它不接受 SQL 字符串，也不处理 params。所谓“带参数的 to_sql”是误解。你传一个含 %s 的字符串进去，只会得到 DatabaseError: (sqlite3.OperationalError) near "%": syntax error 类错误。
- 表名必须来自可信源：禁止
df.to_sql(request.args.get("table"), ...) - 列名需清洗：
df.columns = [re.sub(r'[^a-zA-Z0-9_]', '_', c) for c in df.columns]，防止反引号或注释符干扰 - 写入前校验数据内容：若 DataFrame 来自用户上传 CSV，检查其值是否含
;、--、/*等可能触发语句截断的字符
最易被忽略的一点：即使你用了 params，只要在同一个查询里混用了拼接（比如 f"SELECT * FROM {table_name} WHERE id = ?"），整条语句就退回高危状态——参数化只保护问号部分，前面的拼接仍是裸奔。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
