Coze 워크플로우에서 '유효하지 않은 문자'가 보고되면<' looking for beginning of value`，很多人第一反应是模型坏了，其实大概率不是。公开 issue 里，这种错误通常意味着接口本来应该返回 JSON，结果却返回了一个网页，比如 404 页面、登录页，或者反向代理吐出来的 HTML。换句话说，程序在等数据，却收到了网页。
공식 오픈 소스 버전을 보고 있다면, 저장소 주소는 여전히 coze-dev/coze-studio입니다. 공식 README와 개발 노트는 모델 구성, API 항목, 워크플로우 실행 환경을 먼저 정렬해야 하며, 그렇지 않으면 런타임에 폭발적으로 증가할 가능성이 가장 높다고 강조합니다.
왜 이 오류가 '모델 문제'와 매우 유사한가요?
이는 워크플로우 노드가 실행 중일 때 모델이나 외부 인터페이스를 호출할 때 자주 발생하기 때문입니다. 하지만 진짜 오류 키워드는 ''입니다.<`'，这说明返回内容开头是 HTML 标签而不是 JSON。也就是说，你要查的不是“模型会不会说话”，而是“接口到底回了什么”。
가장 흔한 이유
- 기본 URL이 맞지 않고, 인터페이스가 실제로 API 대신 웹페이지에 도달합니다.
- 경로에 '/v1'이나 추가 프록시 계층이 없어 요청이 잘못된 주소로 전달됩니다.
- 게이트웨이나 Nginx는 오류 페이지를 반환하지만, 프론트엔드는 이를 인터페이스 응답으로 파싱합니다.
지역사회에서 흔히 사용되는 조사 방법
가장 효과적인 방법은 추측하는 것이 아니라 실제 반응을 직접 보는 것입니다. 'curl'이나 브라우저 웹 패널을 사용해 인터페이스가 JSON을 반환하는지 확인할 수 있습니다. 처음부터 HTML이라면, 문제는 주소, 프록시, 인증 점프에 고정되어 있습니다. 오픈 이슈에서 누군가가 비슷한 상황을 겪었고, 결국 서드파티 OpenAPI의 요청 경로가 일치하지 않았거나 프록시 계층이 웹 페이지 콘텐츠를 반환했다는 사실을 알게 되었습니다.
워크플로우를 단계별로 구축할 때는 최소 테스트를 할 수 있는 문제가 없다는 인터페이스를 먼저 사용하고, 그 후 천천히 다른 노드들을 다시 추가하는 것이 권장됩니다. 이렇게 하면 오류가 보고된 후 어떤 계층이 JSON을 HTML로 변환했는지 빠르게 알 수 있습니다.
한 문장 결론
'무효 인물'<'` 不是“模型语法错误”，而是接口响应不对。先查地址、代理和返回内容，往往比改工作流节点更快。
