PHP上传大文件至Oracle的BLOB字段时遇ORA-01704错误求解决

这个问题我之前做项目时也碰到过，直接把大体积的PDF内容用字符串字面量插入BLOB字段肯定会踩ORA-01704的坑——因为Oracle对SQL语句里的字符串字面量有严格的长度限制（通常是4000字节，不同版本可能略有差异）。给你几个实用的解决思路：

1. 使用PL/SQL结合BFILE + 绑定变量（服务器端文件场景） #

如果PDF文件存放在数据库服务器的文件系统上，这种方法最稳妥：

首先需要创建一个数据库目录对象，指向文件所在路径：

CREATE OR REPLACE DIRECTORY PDF_DIR AS '/path/to/your/pdf/files';

然后给当前用户授予该目录的读取权限：

GRANT READ ON DIRECTORY PDF_DIR TO your_username;

接下来用PL/SQL读取文件并插入BLOB字段：

DECLARE
  l_pdf_bfile BFILE;
  l_blob_data BLOB;
BEGIN
  -- 关联服务器上的PDF文件
  l_pdf_bfile := BFILENAME('PDF_DIR', 'your_target.pdf');
  
  -- 初始化临时BLOB并加载文件内容
  DBMS_LOB.OPEN(l_pdf_bfile, DBMS_LOB.LOB_READONLY);
  DBMS_LOB.CREATETEMPORARY(l_blob_data, TRUE);
  DBMS_LOB.LOADFROMFILE(
    dest_lob => l_blob_data,
    src_lob => l_pdf_bfile,
    amount => DBMS_LOB.GETLENGTH(l_pdf_bfile)
  );
  DBMS_LOB.CLOSE(l_pdf_bfile);
  
  -- 用绑定变量插入数据，避免字面量限制
  INSERT INTO tablename (id, blob_column) VALUES ('1', l_blob_data);
  COMMIT;
  
  -- 释放临时BLOB资源
  DBMS_LOB.FREETEMPORARY(l_blob_data);
END;
/

2. 用编程语言直接写入BLOB（客户端文件场景） #

如果PDF在本地客户端，直接用编程语言的数据库驱动传递二进制数据是最方便的，比如Python用cx_Oracle的示例：

import cx_Oracle
import os

# 建立数据库连接
conn = cx_Oracle.connect("your_username/your_password@your_db_host:port/service_name")
cursor = conn.cursor()

# 读取本地PDF文件的二进制内容
with open("local_file.pdf", "rb") as pdf_file:
    pdf_binary = pdf_file.read()

# 使用绑定变量插入，驱动会自动处理大二进制数据
cursor.execute(
    "INSERT INTO tablename (id, blob_column) VALUES (:1, :2)",
    ('1', pdf_binary)
)
conn.commit()

# 关闭资源
cursor.close()
conn.close()

Java、C#等语言的数据库驱动也都支持类似的绑定变量方式，核心都是避免把大数据直接写在SQL语句里。

3. 拆分字符串拼接BLOB（仅应急不推荐） #

如果实在要硬写SQL（不推荐，容易出错且不适用于二进制文件），可以把大内容拆成多个4000字节以内的片段，用DBMS_LOB.APPEND拼接成BLOB：

DECLARE
  l_blob_data BLOB;
BEGIN
  DBMS_LOB.CREATETEMPORARY(l_blob_data, TRUE);
  -- 逐个拼接片段，每个片段不能超过4000字节
  DBMS_LOB.WRITEAPPEND(l_blob_data, LENGTH('first_part'), 'first_part');
  DBMS_LOB.WRITEAPPEND(l_blob_data, LENGTH('second_part'), 'second_part');
  -- ... 重复拼接所有片段
  
  INSERT INTO tablename (id, blob_column) VALUES ('1', l_blob_data);
  COMMIT;
  DBMS_LOB.FREETEMPORARY(l_blob_data);
END;
/

⚠️ 注意：这种方法只适合纯文本内容，PDF是二进制文件，拆分拼接很容易损坏文件结构，所以强烈不建议用在PDF场景。

额外注意事项 #

• 确认表的目标字段确实是BLOB类型，而不是VARCHAR2或CLOB——CLOB虽然存大文本，但同样有字面量长度限制，且不适合二进制的PDF。
• 用BFILE方式时，确保数据库服务器的操作系统用户（比如oracle用户）有读取目标文件路径的权限。

内容的提问来源于stack exchange，提问作者Mehdi Bajjou