PHP MySQL跨库迁移longBLOB附件异常：文件存在但无法下载

我太懂这种憋屈感了——用longBLOB存附件本来就是个临时凑活的方案，还遇上迁移后文件能看到却下不了的坑，先帮你把眼前的问题捋清楚：

从你描述的情况来看，记录能正常插入，但文件损坏无法下载，大概率是BLOB数据在迁移过程中被截断、编码处理出错，或者下载逻辑有疏漏，给你几个针对性的排查和解决方向：

1. 先检查MySQL的max_allowed_packet配置 #

这是最常见的坑！MySQL默认的max_allowed_packet值通常只有4M，如果你的附件超过这个大小，插入时会被悄悄截断，导致文件损坏。

• 先查当前配置：

  SHOW VARIABLES LIKE 'max_allowed_packet';
  

• 临时调整（重启MySQL后失效）：

  SET GLOBAL max_allowed_packet = 67108864; -- 改成64M，根据你的最大文件大小调整
  

• 永久生效：修改MySQL配置文件（my.cnf或my.ini），在[mysqld]段添加：

  max_allowed_packet = 64M
  

  改完记得重启MySQL服务。

2. 别直接拼接SQL，用预处理语句处理BLOB #

如果是用PHP、Java这类语言做迁移，直接把BLOB数据拼进SQL语句里，很容易因为特殊字符、编码问题搞坏二进制数据。一定要用预处理绑定参数的方式插入：

拿PHP举个例子：

// 从DB_1读取数据
$stmt = $db1->prepare("SELECT id, file_name, file_blob FROM attachments");
$stmt->execute();
$stmt->bind_result($id, $fileName, $fileBlob);

// 插入DB_2，用预处理绑定BLOB类型
$insertStmt = $db2->prepare("INSERT INTO attachments (file_name, file_blob) VALUES (?, ?)");
$insertStmt->bind_param("sb", $fileName, $fileBlob); // s=字符串，b=BLOB类型

while ($stmt->fetch()) {
    $insertStmt->send_long_data(1, $fileBlob); // 专门处理大BLOB数据，避免截断
    $insertStmt->execute();
}

3. 验证BLOB数据的完整性 #

迁移前后对比一下数据的长度和哈希，确认有没有丢数据：

• 查BLOB长度：

  SELECT id, file_name, LENGTH(file_blob) AS blob_size FROM attachments;
  

  对比DB_1和DB_2里同一文件的blob_size，不一样的话就是数据被截断了。

• 生成哈希值验证（MySQL 5.5+支持）：

  SELECT id, file_name, SHA2(file_blob, 256) AS blob_hash FROM attachments;
  

  两个库的哈希值对不上，那肯定是迁移过程中数据出问题了。

4. 确认DB_2的字段类型和DB_1一致 #

别大意！如果DB_2里的附件字段是BLOB或者MEDIUMBLOB，而你的文件超过了它们的最大容量，数据会被直接截断：

• BLOB最大存65KB，MEDIUMBLOB最大16MB，LONGBLOB才是4GB上限
  先把DB_2的字段改成和DB_1一样的LONGBLOB，再重新迁移试试。

5. 排查下载逻辑的问题 #

如果前面都没问题，那可能是下载页面的代码坑了自己：

• 有没有正确设置Content-Type头？浏览器识别不了文件类型就会乱码
• 输出BLOB数据前是不是不小心输出了多余字符（比如空格、HTML注释）？这些会混进二进制数据里搞坏文件
• 有没有对BLOB数据做了不必要的编码转换（比如用htmlspecialchars处理二进制内容）？

给你个正确的PHP下载示例参考：

$stmt = $db2->prepare("SELECT file_name, file_blob, content_type FROM attachments WHERE id = ?");
$stmt->bind_param("i", $fileId);
$stmt->execute();
$stmt->bind_result($fileName, $fileBlob, $contentType);
$stmt->fetch();

// 先清空输出缓冲区，避免多余字符
ob_clean();
flush();

header("Content-Type: $contentType");
header("Content-Disposition: attachment; filename=\"$fileName\"");
header("Content-Length: " . strlen($fileBlob));
echo $fileBlob;
exit;

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