根本原因是导出未真正执行带WHERE的SQL，而是从缓存或前端数据中拉取；需确认导出是否直连数据库、验证SQL执行结果、处理特殊字段类型、控制Excel格式、检查权限及导出链路各层。
WHERE 条件写对了，但导出 Excel 时数据还是全量？
根本原因通常是 sql 查询本身没被真正执行——你看到的“导出”其实是从已有结果集（比如前端缓存、上一次查询的临时表、或 ui 展示层的数据）里拉取的。数据库层面的 where 没生效，等于白写。
实操建议：
- 确认导出功能是否直连数据库：查文档或问后端，看它调用的是
SELECT * FROM table还是拼接了你的条件。很多低代码平台/报表工具默认只传参数给前端 JS 过滤，后端压根没重查库 - 在导出前手动执行一遍完整 SQL，复制到数据库客户端（如 DBeaver、MySQL Workbench）里跑一下，核对返回行数是否符合预期
- 如果用 Python 的
pandas.read_sql()，必须把带WHERE的完整 SQL 字符串传进去，别依赖df[df.col == x]后再导出——那是内存过滤，不是 SQL 过滤
SQL Server / MySQL / PostgreSQL 导出到 Excel 的常见断点
不是所有数据库都原生支持“直接生成 .xlsx”。多数情况是先查出结果，再由应用层转成 Excel 格式，中间容易卡在类型转换或大字段上。
实操建议：
-
TEXT、JSON、BYTEA类型字段在导出时可能报错或变空，导出前加CAST(col AS VARCHAR(8000))或TO_CHAR(col)强制转字符串 - MySQL 8.0+ 的
JSON_EXTRACT()结果默认是 JSON 类型，Excel 不认，得包一层JSON_UNQUOTE() - PostgreSQL 的
ARRAY或HSTORE字段会导出成字符串形式（如"{a,b,c}"），如果业务需要拆开列，得提前用UNNEST()或json_to_recordset() - 行数超 10 万时，Excel 的 .xls 格式会失败（最大 65536 行），必须用
.xlsx，且导出逻辑要支持流式写入（如 Python 用openpyxl的write_only=True模式）
Python pandas.to_excel() 导出时日期/数字格式错乱
Excel 会自动识别并格式化数值和时间，但 pandas 默认不控制单元格格式，导致导出后显示为科学计数法、时区偏移、或日期变成浮点数（Excel 底层用天数表示日期）。
实操建议：
- 导出前统一转类型：
df['date_col'] = pd.to_datetime(df['date_col']).dt.date（去掉时间部分）、df['num_col'] = df['num_col'].astype(float) - 用
ExcelWriter显式控制格式：with pd.ExcelWriter('out.xlsx', engine='openpyxl') as writer: df.to_excel(writer, index=False) workbook = writer.book worksheet = writer.sheets['Sheet1'] date_format = workbook.add_format({'num_format': 'yyyy-mm-dd'}) worksheet.set_column('B:B', 12, date_format) # 假设 B 列是日期 - 避免用
to_csv().to_excel()这种绕路操作——CSV 会丢失类型信息，再读回来又是一轮解析误差
权限不足导致导出失败但错误提示极不明确
典型现象是点击导出没反应、卡住、或返回 500 Internal Server Error，但日志里只有 Permission denied 或空 traceback。背后常是数据库账号没开文件写入权限，或应用服务器磁盘满、临时目录不可写。
实操建议：
- 检查数据库账号是否有
SELECT权限——重点看是否只给了视图权限，但视图底层引用的表没授权 - 如果是用
INTO OUTFILE（MySQL）或COPY ... TO（PostgreSQL），注意这是服务端文件操作，权限取决于数据库进程的 OS 用户，不是你的登录账号 - Python 脚本导出时，确保运行用户对输出路径有写权限，且磁盘剩余空间 > 预估 Excel 文件大小 × 2（因为 openpyxl 写入是先建临时文件）
- 某些云数据库（如阿里云 RDS、AWS RDS）禁用了服务端文件导出命令，只能走客户端查 + 应用层生成，这点必须提前确认
最麻烦的不是语法写错，而是导出链路横跨数据库、中间件、前端、本地 Excel 客户端四层，任何一层悄悄做了缓存、截断或类型转换，都会让 WHERE 条件看起来“失效”。动手前先抓包或打日志，确认 SQL 真的发到了数据库，而且返回的就是你要的那几行。
