{"record":{"id":"61200a4cfdbf1f15","repo":"OtterMind/Chat2DB","slug":"message-must-be-non-empty-text","errorCode":null,"errorMessage":"message must be non-empty text","messagePattern":"message must be non-empty text","errorType":"http","errorClass":"RequestError","httpStatus":400,"severity":"error","filePath":"script/github/qq_relay/relay_server.py","lineNumber":226,"sourceCode":"            raise RequestError(HTTPStatus.REQUEST_ENTITY_TOO_LARGE, \"request body is too large\")\n        try:\n            payload = json.loads(self.rfile.read(content_length).decode(\"utf-8\"))\n        except (UnicodeDecodeError, json.JSONDecodeError) as error:\n            raise RequestError(HTTPStatus.BAD_REQUEST, \"request body is not valid JSON\") from error\n        if not isinstance(payload, Mapping):\n            raise RequestError(HTTPStatus.BAD_REQUEST, \"request body must be a JSON object\")\n        return payload\n\n    def _validate_payload(self, payload: Mapping[str, Any]) -> tuple[str, str]:\n        config = self.relay_state.config\n        if payload.get(\"repository\") != config.repository:\n            raise RequestError(HTTPStatus.FORBIDDEN, \"repository is not allowed\")\n        delivery_id = payload.get(\"delivery_id\")\n        if not isinstance(delivery_id, str) or not DELIVERY_ID_PATTERN.fullmatch(delivery_id):\n            raise RequestError(HTTPStatus.BAD_REQUEST, \"delivery_id is invalid\")\n        message = payload.get(\"message\")\n        if not isinstance(message, str) or not message.strip():\n            raise RequestError(HTTPStatus.BAD_REQUEST, \"message must be non-empty text\")\n        if len(message) > config.max_message_length:\n            raise RequestError(HTTPStatus.BAD_REQUEST, \"message is too long\")\n        if CONTROL_CHARACTER_PATTERN.search(message):\n            raise RequestError(HTTPStatus.BAD_REQUEST, \"message contains control characters\")\n        return delivery_id, message\n\n    def do_GET(self) -> None:  # noqa: N802\n        if self.path == \"/healthz\":\n            self._send_json(HTTPStatus.OK, {\"ok\": True})\n            return\n        self._send_json(HTTPStatus.NOT_FOUND, {\"error\": \"not found\"})\n\n    def do_POST(self) -> None:  # noqa: N802\n        delivery_id = \"\"\n        reserved = False\n        try:\n            if self.path != \"/v1/qq/github\":\n                raise RequestError(HTTPStatus.NOT_FOUND, \"not found\")","sourceCodeStart":208,"sourceCodeEnd":244,"githubUrl":"https://github.com/OtterMind/Chat2DB/blob/5ee1e990e73fbcae1969dc554be254fedb3ab888/script/github/qq_relay/relay_server.py#L208-L244","documentation":"Raised at relay_server.py:225 when \"message\" is missing, not a str, or is whitespace-only (not message.strip()). The relay forwards this text verbatim to the QQ group via OneBot, so it must carry visible content. Returned as HTTP 400.","triggerScenarios":"message omitted; set to \"\"; a string of only spaces/tabs/newlines; or sent as a number/list instead of a string.","commonSituations":"Empty GitHub event rendered to blank text; template collapses to whitespace; field name typo ('text'/'body' instead of 'message'); event type the template does not handle.","solutions":["Ensure message is a non-empty string after .strip() before posting.","Render a sensible fallback when the event text is blank.","Double-check the field name is exactly \"message\"."],"exampleFix":"# before\npayload[\"message\"] = event_text.strip()\n# after\npayload[\"message\"] = event_text.strip() or \"GitHub event received\"","handlingStrategy":"validation","validationCode":"msg = payload.get('message')\nif not isinstance(msg, str) or not msg.strip():\n    raise ValueError('message must be non-empty text')","typeGuard":"def has_non_empty_message(payload: dict) -> bool:\n    msg = payload.get('message')\n    return isinstance(msg, str) and bool(msg.strip())","tryCatchPattern":"resp = requests.post(url, json=payload)\nif resp.status_code == 400 and 'non-empty' in resp.json().get('error', ''):\n    payload['message'] = 'GitHub event received'  # fallback text","preventionTips":["Default message to a fallback when the rendered text is blank.","Confirm the field key is exactly 'message'."],"tags":["http","validation","qq-relay"],"backgroundTag":null,"analyzedSha":"5ee1e990e73fbcae1969dc554be254fedb3ab888","analyzedAt":"2026-08-14T07:05:03.077Z","schemaVersion":2},"datasetVersion":"2026-08-14T10:17:34.591Z"}