FastAPI上传文件至MySQL BLOB时遭遇UnicodeDecodeError问题

问题原因 #

你遇到的UnicodeDecodeError是因为PNG、DOCX、PDF这类文件属于二进制文件，而非UTF-8文本文件。当代码尝试以文本编码方式读取这些文件内容时，就会因二进制字节不符合UTF-8编码规则触发解码错误——比如PNG文件开头的0x89字节，本身就不是有效的UTF-8起始字节。

另外你的代码里存在多余的本地文件写入操作，这不仅没必要，还可能因文件打开方式不当加重问题（不过从报错看，核心问题还是出在文件读取阶段的编码处理）。

解决方案 #

1. 直接使用二进制数据存入数据库 #

你不需要先把文件写入本地，直接读取二进制内容后存入MySQL即可，这能避免本地文件操作带来的额外问题：

try:
    # 读取二进制文件内容
    blob_data = CV.file.read()
    # 执行MySQL存储操作（示例）
    # cursor.execute("INSERT INTO your_table (cv_blob) VALUES (%s)", (blob_data,))
    # conn.commit()
    return {"message": "文件已成功存储"}
except UnicodeDecodeError:
    return {"message": "无法以UTF-8编码读取二进制文件，请检查文件处理模式"}
except Exception as e:
    return {"message": f"存储失败: {str(e)}"}
finally:
    CV.file.close()

2. 确保文件对象以二进制模式处理 #

如果你的文件接收逻辑（比如用FastAPI的UploadFile）被误配置为文本模式，需显式指定二进制模式。对于FastAPI的UploadFile，其自带的file属性默认就是二进制模式，无需额外配置，但要避免在代码中手动将其转为文本流。

3. 移除多余的本地文件写入 #

你当前代码里的本地文件写入步骤完全没必要，直接用read()得到的二进制数据就能存入MySQL的BLOB字段，删掉这部分代码可以减少出错点。

关于文件仍能存入数据库的说明 #

报错但文件仍能存入，大概率是因为存储数据库的逻辑在报错触发前已经执行完成，或者错误是由本地文件写入步骤引发的，不影响数据库存储逻辑。但这个错误会干扰接口的正常响应，必须修复。

内容的提问来源于stack exchange，提问作者OLUYELE SUNDAY ANTHONY