UTL_FILE读写前必须创建DIRECTORY对象，其路径需在数据库服务器本地存在且oracle用户有读写权限，FOPEN的第一个参数只能是DIRECTORY名称而非路径字符串。
UTL_FILE 读写前必须创建 DIRECTORY 对象
oracle 不允许 utl_file 直接操作任意文件路径，所有路径必须先通过 create directory 声明为数据库对象。没这步，fopen 会直接报 ora-29280: invalid directory path。
-
DIRECTORY是数据库对象，需CREATE ANY DIRECTORY权限（通常只给 DBA 或应用专用账号） - 目录路径必须存在于数据库服务器本地文件系统，不是客户端机器
- Oracle 用户（如
oracle进程用户）必须对目标目录有读/写权限，否则FOPEN成功但PUT_LINE或GET_LINE报ORA-29283: invalid file operation - 示例：
CREATE OR REPLACE DIRECTORY log_dir AS '/u01/app/oracle/logs';
然后授权：GRANT READ, WRITE ON DIRECTORY log_dir TO app_user;
UTL_FILE.FOPEN 的 location 参数必须是 DIRECTORY 名，不是路径字符串
很多人把 FOPEN 第一个参数写成真实路径（比如 '/tmp/out.txt'），这是错的——它只能是已创建的 DIRECTORY 对象名，文件名是第二个参数。
- 正确：
l_file := UTL_FILE.FOPEN('LOG_DIR', 'output.txt', 'W'); - 错误：
l_file := UTL_FILE.FOPEN('/u01/app/oracle/logs', 'output.txt', 'W'); -- ORA-29280 - 大小写敏感：
LOG_DIR和log_dir在部分 Oracle 版本中不等价，建议全大写并保持一致 - 模式参数仅支持
'R'、'W'、'A'，不支持'r+'或'wb'等 C 风格写法
读写内容受 utl_file_dir 和 max_open_files 限制
即使 DIRECTORY 创建成功，仍可能因实例级配置被拦截。尤其老版本 Oracle（11g 及之前）还依赖 utl_file_dir 参数。
- 如果数据库启用了
utl_file_dir = '*'，UTL_FILE可能绕过DIRECTORY限制（不安全，已弃用），但 12c+ 默认禁用该参数，强制走DIRECTORY -
UTL_FILE同时打开的文件数受限于隐含参数_utl_file_max_open_files（默认 50），超限报ORA-29284: file read error或ORA-29285: file write error - 每次
FOPEN后务必配对FCLOSE；异常分支漏关会导致句柄泄漏，很快触达上限 - 大文件逐行读写时，别用
GET_LINE无限制循环——没换行符的超长行会触发ORA-29284，建议加MAX_LINESIZE参数并捕获异常
中文或特殊字符写入乱码的关键原因
文件内容显示乱码，大概率不是编码问题本身，而是 NLS_LANG 与文件实际编码不匹配，且 UTL_FILE 不做字符集转换。
-
UTL_FILE写出的是数据库字符集（如AL32UTF8）的原始字节，不识别 BOM，也不自动转码 - 若用记事本打开乱码，大概率是它误判编码——改用 VS Code 或 Notepad++ 并手动选 UTF-8（无 BOM）查看
- 避免在文件名里用中文或空格，某些 Oracle 版本对非 ASCII 文件名支持不稳定
- 跨平台注意换行符：
PUT_LINE在 Linux 写\n，Windows 应用可能需要\r\n，得自己拼接PUT+NEW_LINE
Oracle 的 UTL_FILE 行为高度绑定数据库服务器环境，任何一步脱离“服务端路径 + 目录对象 + 进程权限 + 实例参数”这个闭环，都会在某个环节静默失败。最常被跳过的其实是操作系统层面的文件权限检查——DBA 能 CREATE DIRECTORY，不代表 oracle 用户能往那个目录里写。
