Function snapshot_import

backend/api.py:1377–1416

从上传的 JSON 文件导入快照并立即恢复仿真状态。 Content-Type: application/json → JSON 解析 同时接受 multipart/form-data 中的 ``file`` 字段（前端文件上传）。

()

@require_role('admin')
@rate_limit(10, 60)
def snapshot_import():
    """从上传的 JSON 文件导入快照并立即恢复仿真状态。

    Content-Type: application/json  → JSON 解析
    同时接受 multipart/form-data 中的 ``file`` 字段（前端文件上传）。
    """
    content_type = request.content_type or ""

    if "multipart/form-data" in content_type:
        file = request.files.get("file")
        if file is None:
            return error_response("VALIDATION_ERROR", "multipart 请求中未找到 'file' 字段")
        raw_text = file.read(4 * 1024 * 1024).decode("utf-8", errors="replace")
    else:
        raw_bytes = request.get_data()
        raw_text = raw_bytes.decode("utf-8", errors="replace")

    if not raw_text.strip():
        return error_response("VALIDATION_ERROR", "请求体为空")

    try:
        snap_data = _SnapshotManager.from_json(raw_text)
    except ValueError as ve:
        return error_response("VALIDATION_ERROR", f"快照解析失败: {ve}")

    errors = _SnapshotManager.validate(snap_data)
    if errors:
        return error_response("VALIDATION_ERROR", "; ".join(errors))

    try:
        result = simulation_engine.restore(snap_data)
    except ValueError as ve:
        return error_response("VALIDATION_ERROR", str(ve))
    except Exception:
        logger.exception("快照导入恢复失败")
        return error_response("INTERNAL_ERROR")

    global _saved_snapshot
    _saved_snapshot = snap_data
    return ok(result)


# ==========================================