dxf 文件常含二进制数据，直接按 utf-8 解码为字符串再转 stringio 会导致解析失败；应使用 bytesio 传递原始字节流给 ezdxf.read()，确保格式兼容性与解析稳定性。
dxf 文件常含二进制数据，直接按 utf-8 解码为字符串再转 stringio 会导致解析失败；应使用 bytesio 传递原始字节流给 ezdxf.read()，确保格式兼容性与解析稳定性。
在 FastAPI 应用中处理 DXF 文件上传时，一个常见误区是将二进制文件内容错误地当作纯文本处理。DXF 格式虽有 ASCII 模式（如 DXF R12），但现代 CAD 软件导出的 DXF 文件普遍采用 Binary DXF（以 0x00 字节分隔段、含压缩或二进制实体）或混合模式。一旦调用 .decode('utf-8')，二进制字节（如 0x00, 0xFF）会触发 UnicodeDecodeError 或产生乱码，后续传入 io.StringIO 的非法字符串将导致 ezdxf.read() 在解析结构时抛出 DXFStructureError: Invalid binary data near line: XXX —— 实际上该“行号”是解析器在损坏字符串中误判的伪位置，并非真实 DXF 行号。
✅ 正确做法是：跳过解码环节，直接将原始字节流封装为 io.BytesIO 对象，交由 ezdxf.read() 原生处理。ezdxf.read() 内部已完整支持 ASCII 和 Binary DXF 的自动识别与解析，无需人工干预编码。
以下是推荐的健壮实现：
import io
import ezdxf
from fastapi import UploadFile, File, HTTPException
from fastapi.responses import JSONResponse
async def read_dxf_file(upload_file: UploadFile) -> ezdxf.document.Drawing:
"""
安全读取上传的 DXF 文件，支持 ASCII 与 Binary DXF 格式。
"""
try:
dxf_bytes = await upload_file.read()
if not dxf_bytes:
raise ValueError("Uploaded file is empty")
# ✅ 关键：使用 BytesIO 直接传递二进制流
dxf_stream = io.BytesIO(dxf_bytes)
doc = ezdxf.read(dxf_stream)
return doc
except ezdxf.DXFStructureError as e:
raise ValueError(f"Invalid DXF structure: {e}")
except ezdxf.DXF IOError as e:
raise ValueError(f"IO error while reading DXF: {e}")
except Exception as e:
raise ValueError(f"Failed to read DXF file: {e}")
# FastAPI 路由示例
@app.post("/upload-dxf/")
async def upload_dxf_endpoint(upload_file: UploadFile = File(...)):
if not upload_file.filename.lower().endswith(('.dxf', '.DXF')):
raise HTTPException(400, "Only .dxf files are allowed")
try:
doc = await read_dxf_file(upload_file)
# 示例：获取图层数量与实体总数
layer_count = len(doc.layers)
entity_count = len(list(doc.modelspace()))
return JSONResponse({
"success": True,
"layers": layer_count,
"entities_in_modelspace": entity_count,
"version": doc.dxfversion
})
except ValueError as e:
raise HTTPException(400, str(e))
⚠️ 注意事项：
- 禁止对 DXF 字节流进行任何 .decode() 操作：DXF 不是 UTF-8 文本，强行解码必然破坏二进制结构；
- 验证文件扩展名与非空性：防止恶意上传或空文件引发未定义行为；
- 捕获具体 ezdxf 异常：如 DXFStructureError（格式错误）、DXF IOError（I/O 失败），便于前端精准反馈；
- 若需进一步校验 DXF 合规性，可调用 doc.validate()（需 ezdxf ≥ 1.1.0），但注意该操作可能较耗时。
总结：DXF 是二进制友好的交换格式，ezdxf.read() 的设计初衷即为接收原始字节流。坚持使用 io.BytesIO 是解决此类问题的根本路径，既简洁又可靠。
