| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758 |
- import re
- from jsonschema import validate, ValidationError
- from app.core.biz_exception import BizLogicError
- def validate_user_inputs(schema_json: dict, user_inputs: dict):
- """
- Validate user inputs against the product's JSON Schema.
- Produces clear, human-readable English error messages identifying the exact field.
- """
- if not schema_json:
- return
- if user_inputs is None:
- user_inputs = {}
- if not isinstance(user_inputs, dict):
- raise BizLogicError(f"Invalid parameter [root]: Expected object, got {type(user_inputs).__name__}")
- try:
- validate(instance=user_inputs, schema=schema_json)
- except ValidationError as e:
- path_prefix = ".".join(map(str, e.path))
- # 1. 必填字段缺失错误 (required)
- if e.validator == 'required':
- match = re.search(r"'([^']+)' is a required property", e.message)
- missing_prop = match.group(1) if match else (e.validator_value[0] if isinstance(e.validator_value, list) and e.validator_value else "unknown")
- field = f"{path_prefix}.{missing_prop}" if path_prefix else missing_prop
- # 尝试从 properties 中获取该字段的人类可读名称 (title)
- prop_schema = e.schema.get("properties", {}).get(missing_prop, {}) if isinstance(e.schema, dict) else {}
- field_name = prop_schema.get("title") or missing_prop
- raise BizLogicError(f"Missing required field [{field}]: '{field_name}' is required")
- # 2. 正则格式错误 (pattern)
- elif e.validator == 'pattern':
- field = path_prefix or "root"
- prop_title = e.schema.get("title") or field if isinstance(e.schema, dict) else field
- desc = e.schema.get("description") if isinstance(e.schema, dict) else None
- detail = f" ({desc})" if desc else f" ({e.message})"
- raise BizLogicError(f"Invalid parameter [{field}]: '{prop_title}' format is invalid{detail}")
- # 3. 字段类型错误 (type)
- elif e.validator == 'type':
- field = path_prefix or "root"
- prop_title = e.schema.get("title") or field if isinstance(e.schema, dict) else field
- raise BizLogicError(f"Invalid parameter [{field}]: '{prop_title}' must be of type '{e.validator_value}'")
- # 4. 未知扩展字段错误 (additionalProperties)
- elif e.validator == 'additionalProperties':
- field = path_prefix or "root"
- raise BizLogicError(f"Invalid parameter [{field}]: {e.message}")
- # 5. 其他类型验证错误 (enum, minimum, maximum, etc.)
- else:
- field = path_prefix or "root"
- prop_title = e.schema.get("title") if isinstance(e.schema, dict) else None
- prefix = f"'{prop_title}': " if (prop_title and field != "root") else ""
- raise BizLogicError(f"Invalid parameter [{field}]: {prefix}{e.message}")
|