使用UTL_FILE导出CSV需满足三前提：数据库服务器存在可写目录、该目录已通过CREATE DIRECTORY注册、执行用户被授予READ/WRITE权限；否则UTL_FILE.FOPEN报错。
直接用 utl_file 导出 csv 是可行的，但必须满足三个硬性前提：数据库服务器上有可写的操作系统目录、该目录已通过 create directory 注册进数据库、执行用户被显式授予 read 和 write 权限。缺一不可，否则连 utl_file.fopen 都会报错。
创建并授权 DIRECTORY 对象必须由 DBA 或有 CREATE ANY DIRECTORY 权限的用户操作
普通用户不能自己建目录。常见错误是用应用账号直接执行 CREATE DIRECTORY，结果报 ORA-01031: insufficient privileges。
- 以
SYS或SYSTEM登录：sqlplus / as sysdba - 建目录（路径必须真实存在且 Oracle 进程有写权限）：
CREATE OR REPLACE DIRECTORY export_dir AS '/u01/app/oracle/export'; - 授予权限（注意：不是给目录“赋权”，而是把目录对象的
READ/WRITE权限授予目标用户）：GRANT READ, WRITE ON DIRECTORY export_dir TO myuser; - 验证：登录
myuser后查SELECT * FROM all_directories WHERE directory_name = 'EXPORT_DIR';，确保能看到且OWNER是SYS
UTL_FILE.FOPEN 的第三个参数必须是 'W'，第四个参数建议显式指定
UTL_FILE.FOPEN 第四个参数是最大行宽（单位字节），默认 1024，但 CSV 行常超长。不设或设太小会导致 ORA-29285: file write error —— 实际是写入被截断，而非磁盘满。
- 安全写法：
L_OUTPUT := UTL_FILE.FOPEN('EXPORT_DIR', 'data.csv', 'W', 32767); - 目录名必须大写（
ALL_DIRECTORIES中存的是大写），哪怕你建的时候写了小写，查询也返回大写 - 文件名不能含路径，只写文件名；路径由 DIRECTORY 对象绑定
- 不要在存储过程中拼接路径字符串传给
FOPEN，它不接受完整 OS 路径
处理 CLOB、DATE、NULL 和双引号需手动转义
UTL_FILE.PUT_LINE 不做任何格式化。字段含换行、逗号、双引号时，CSV 解析器会误判结构；CLOB 超 4000 字节会截断；NULL 直接拼成空字符串易与空值混淆。
- 日期统一转字符串：
TO_CHAR(date_col, 'YYYY-MM-DD HH24:MI:SS')，并在过程开头用ALTER SESSION SET NLS_DATE_FORMAT避免会话级格式影响 - CLOB 必须用
DBMS_LOB.SUBSTR(clob_col, 4000, 1)截取，或改用DBMS_SQL.DEFINE_COLUMN_LONG（复杂且易错，小数据量建议截取） - 双引号转义逻辑必须手写：
'"' || REPLACE(col, '"', '""') || '"'，且整个字段必须用双引号包裹 - 显式处理
NULL：NVL(TO_CHAR(num_col), 'NULL')或留空，但需和业务方对齐空值语义
别忽略异常处理和资源释放
最常见的线上事故是：导出中途失败，文件句柄没关，下次执行 FOPEN 报 ORA-29283: invalid file operation，实际是前次残留句柄占着文件。
- 必须在
EXCEPTION块中加IF UTL_FILE.IS_OPEN(file_handle) THEN UTL_FILE.FCLOSE(file_handle); END IF; - 游标也要关：
IF cursor_handle%ISOPEN THEN CLOSE cursor_handle; END IF; - 不要依赖“过程结束自动释放”——PL/SQL 不保证这点，尤其发生异常时
- 大表导出建议加
COMMIT控制事务粒度，但UTL_FILE本身不参与事务，写文件动作不可回滚
真正难的不是写几行 PUT_LINE，而是目录权限链路、字符边界控制、异常后状态清理这三处。很多脚本本地跑通，一上生产就卡在权限或文件锁上，先确认这三点再调逻辑。
