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}")