{"title":"คำถามที่พบบ่อยเกี่ยวกับการแก้ปัญหา","slug":"troubleshooting","category":"faq","summary":"วิธีแก้ปัญหา Synapse ทั่วไป — auth, เครือข่าย, ข้อมูล, deployment","audience":["human","llm"],"tags":["faq","troubleshooting","problems","solutions"],"difficulty":"beginner","updated":"2026-06-27","word_count":510,"read_minutes":3,"lang":"th","translated":true,"requested_lang":"th","content_markdown":"\n# คำถามที่พบบ่อยเกี่ยวกับการแก้ปัญหา\n\nวิธีแก้ปัญหา Synapse ทั่วไป\n\n## ฉันล็อกอินไม่ได้\n\n### อาการ\n\n- `POST /login` ส่งกลับ 401\n- \"Invalid email or password\"\n\n### วิธีแก้\n\n1. **ตรวจสอบ email ถูกต้อง** — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่\n2. **ตรวจสอบรหัสผ่าน** — ขั้นต่ำ 6 ตัวอักษร\n3. **สมัครก่อน** หากคุณยังไม่มีบัญชี: `POST /register`\n4. **รีเซ็ตรหัสผ่าน** (หากกำหนดค่า SMTP แล้ว) ผ่าน web UI\n\n## ฉันสูญเสีย Mind Key\n\n### อาการ\n\n- เข้าถึง memory ไม่ได้\n- Mind Key ถูกลบ/สูญหาย\n\n### วิธีแก้\n\nMind Key กู้คืนไม่ได้ คุณต้อง:\n\n1. ล็อกอินเพื่อรับ JWT: `POST /login`\n2. รายการ mind: `GET /minds` (ด้วย JWT)\n3. สร้าง mind ใหม่: `POST /minds`\n4. บันทึก Mind Key ใหม่\n5. (ตัวเลือก) ลบ mind เก่า: `DELETE /minds/:id`\n\n**ข้อมูลใน mind เก่าสูญหาย** เว้นแต่คุณหา Mind Key ได้\n\n## API call ส่งกลับ 401\n\n### อาการ\n\n- API call ทั้งหมดส่งกลับ 401 Unauthorized\n- \"Mind Key fehlt oder ungültig\"\n\n### วิธีแก้\n\n1. **ตรวจสอบรูปแบบ header**: `Authorization: Bearer mk_...`\n2. **ตรวจ Mind Key ขึ้นต้นด้วย `mk_`** (ไม่ใช่ `eyJ` ซึ่งเป็น JWT)\n3. **ทดสอบโดยตรง**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n4. **Mind Key อาจถูกเพิกถอน** — สร้าง mind ใหม่\n\nดู [Authentication](/docs/getting-started/authentication)\n\n## API call ส่งกลับ 404\n\n### อาการ\n\n- 404 Not Found\n- \"Route not found\"\n\n### วิธีแก้\n\n> [!CRITICAL]\n> อย่าเดา endpoint path มีเพียง path ใน `GET /endpoints` เท่านั้นที่มีอยู่\n\n1. **ตรวจสอบ endpoint ที่ถูกต้อง**: `curl https://synapse.schaefer.zone/endpoints`\n2. **เปรียบเทียบ URL ตรงตัว** — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่, ไม่มี trailing slash\n3. **ตรวจสอบ HTTP method** — `GET /memory` กับ `POST /memory` ต่างกัน\n\n## API call ส่งกลับ 429\n\n### อาการ\n\n- 429 Too Many Requests\n- \"Rate limit exceeded\"\n\n### วิธีแก้\n\n1. **เปลี่ยนไปใช้ header auth** (ไม่จำกัดอัตรา):\n ```bash\n # Don't\n curl \".../memory/recall?key=mk_...\"\n \n # Do\n curl -H \"Authorization: Bearer mk_...\" .../memory/recall\n ```\n2. **รอ `Retry-After` วินาที** หากต้องใช้ `?key=`\n\nดู [Rate Limits](/docs/api/rate-limits)\n\n## การค้นหา memory ส่งกลับไม่มีผลลัพธ์\n\n### อาการ\n\n- `GET /memory/search?q=...` ส่งกลับว่าง\n- รู้ว่ามี memory อยู่\n\n### วิธีแก้\n\n1. **ตรวจสอบ memory มีอยู่**: `GET /memory/recall`\n2. **ตรวจสอบไวยากรณ์ search** — FTS5 มีไวยากรณ์เฉพาะ\n3. **ลอง query ที่ง่ายกว่า** — `?q=docker` แทน `?q=docker+swarm+deployment`\n4. **ใช้ semantic search** สำหรับ query เชิงแนวคิด: `GET /memory/semantic-search?q=...`\n\nดู [FTS5 Search](/docs/concepts/fts5-search)\n\n## memory ไม่คงอยู่\n\n### อาการ\n\n- POST /memory ส่งกลับสำเร็จ\n- GET /memory/recall ไม่แสดง memory เหล่านั้น\n\n### วิธีแก้\n\n1. **ตรวจสอบ Mind Key เดียวกัน** — key ต่างกัน = mind ต่างกัน\n2. **ตรวจสอบ response** — POST ส่งกลับ `{ \"id\": \"mem_...\", \"status\": \"stored\" }`\n3. **ลอง GET /memory** (รายการ JSON) แทน /memory/recall (text)\n4. **ตรวจสอบ filter** — `?category=` หรือ `?tag=` อาจซ่อนไว้\n\n## tool ไม่ปรากฏใน Claude Desktop\n\n### อาการ\n\n- Claude Desktop แสดง 0 tool\n- ไม่มีไอคอน 🔌\n\n### วิธีแก้\n\n1. **รีสตาร์ท Claude Desktop ให้เต็มรูปแบบ** (Cmd+Q)\n2. **ตรวจสอบ config file** เป็น JSON ที่ถูกต้อง\n3. **ตรวจ Node.js 18+** ติดตั้ง\n4. **รัน MCP ด้วยตนเอง**: `npx -y synapse-mcp-api@latest`\n5. **ตรวจ log**: `~/Library/Logs/Claude/mcp.log`\n\nดู [MCP Troubleshooting](/docs/mcp/troubleshooting)\n\n## Synapse ออฟไลน์\n\n### อาการ\n\n- เข้าถึง synapse.schaefer.zone ไม่ได้\n- curl หมดเวลา\n\n### วิธีแก้\n\n1. **ตรวจสอบอินเทอร์เน็ต** — ลองเว็บไซต์อื่น\n2. **ตรวจสอบสุขภาพ Synapse**: `curl https://synapse.schaefer.zone/health`\n3. **รอ** — อาจเป็น outage ชั่วคราวหรือ deployment\n4. **ตรวจสอบหน้าสถานะ** (หากมี)\n\nสำหรับ self-host: ตรวจสอบสถานะ Docker container, การเชื่อมต่อฐานข้อมูล\n\n## ข้อผิดพลาดฐานข้อมูล\n\n### อาการ\n\n- 500 Internal Server Error\n- \"Database connection failed\"\n\n### วิธีแก้\n\nสำหรับ self-host:\n\n1. **ตรวจ PostgreSQL รันอยู่**: `docker ps | grep postgres`\n2. **ตรวจ DATABASE_URL** ใน env\n3. **ตรวจ migration**: `npm run migrate:check`\n4. **ตรวจพื้นที่ดิสก์**: `df -h`\n\nสำหรับโฮสต์: รายงานไปยัง support\n\n## Webhook ไม่ทำงาน\n\n### อาการ\n\n- ลงทะเบียน webhook แล้วแต่ไม่ได้รับ callback\n- ไม่มี POST ไปยัง URL ของคุณ\n\n### วิธีแก้\n\n1. **ตรวจสอบ URL เข้าถึงได้**: `curl -X POST your-url -d '{}'`\n2. **ตรวจสอบ filter event** — `memory.*` ตรงทุก memory event\n3. **ทดสอบ webhook**: `POST /webhooks/:id/test`\n4. **ตรวจ webhook เปิดใช้งาน**: `GET /webhooks/:id`\n5. **ตรวจสอบ SSL** — Synapse ต้องการ HTTPS ที่ถูกต้องสำหรับ webhook URL\n\nดู [Webhooks API](/docs/api/webhooks)\n\n## Cron job ไม่รัน\n\n### อาการ\n\n- สร้าง cron job แล้วแต่ไม่ทำงาน\n- `next_run` ไม่อัปเดต\n\n### วิธีแก้\n\n1. **ตรวจไวยากรณ์ schedule** — ต้องเป็น 5-field cron หรือ integer วินาที\n2. **ตรวจ endpoint ได้รับอนุญาต** — ต้องเป็น http(s), ไม่มี private IP\n3. **ตรวจ job เปิดใช้งาน**: `GET /cron`\n4. **รอเวลาที่ตั้งเวลาไว้ถัดไป** — cron ไม่ใช่ทันที\n\nดู [Cron & Scheduler](/docs/api/cron)\n\n## ต้องการความช่วยเหลือเพิ่มเติม?\n\n1. **ตรวจเอกสารที่มี**: \n2. **ค้นหาเอกสาร**: `GET /docs/search?q=your+question`\n3. **เปิด issue**: \n4. **ติดต่อ**: ดูหน้า `/support`\n\n## ขั้นตอนถัดไป\n\n- [Errors & Error Handling](/docs/api/errors)\n- [คำถามที่พบบ่อยเกี่ยวกับ API](/docs/faq/api-faq)\n- [MCP Troubleshooting](/docs/mcp/troubleshooting)\n","content_html":"

คำถามที่พบบ่อยเกี่ยวกับการแก้ปัญหา

\n

วิธีแก้ปัญหา Synapse ทั่วไป

\n

ฉันล็อกอินไม่ได้

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. ตรวจสอบ email ถูกต้อง — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่
    2. \n
  2. ตรวจสอบรหัสผ่าน — ขั้นต่ำ 6 ตัวอักษร
    3. \n
  3. สมัครก่อน หากคุณยังไม่มีบัญชี: POST /register
    4. \n
  4. รีเซ็ตรหัสผ่าน (หากกำหนดค่า SMTP แล้ว) ผ่าน web UI
    5. \n
\n

ฉันสูญเสีย Mind Key

\n

อาการ

\n\n

วิธีแก้

\n

Mind Key กู้คืนไม่ได้ คุณต้อง:

\n
    \n
  1. ล็อกอินเพื่อรับ JWT: POST /login
    2. \n
  2. รายการ mind: GET /minds (ด้วย JWT)
    3. \n
  3. สร้าง mind ใหม่: POST /minds
    4. \n
  4. บันทึก Mind Key ใหม่
    5. \n
  5. (ตัวเลือก) ลบ mind เก่า: DELETE /minds/:id
    6. \n
\n

ข้อมูลใน mind เก่าสูญหาย เว้นแต่คุณหา Mind Key ได้

\n

API call ส่งกลับ 401

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. ตรวจสอบรูปแบบ header: Authorization: Bearer mk_...
    2. \n
  2. ตรวจ Mind Key ขึ้นต้นด้วย mk_ (ไม่ใช่ eyJ ซึ่งเป็น JWT)
    3. \n
  3. ทดสอบโดยตรง:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    4. \n
  4. Mind Key อาจถูกเพิกถอน — สร้าง mind ใหม่
    5. \n
\n

ดู Authentication

\n

API call ส่งกลับ 404

\n

อาการ

\n\n

วิธีแก้

\n
อย่าเดา endpoint path มีเพียง path ใน `GET /endpoints` เท่านั้นที่มีอยู่
    \n
  1. ตรวจสอบ endpoint ที่ถูกต้อง: curl https://synapse.schaefer.zone/endpoints
    2. \n
  2. เปรียบเทียบ URL ตรงตัว — sensitive ต่อตัวพิมพ์เล็ก/ใหญ่, ไม่มี trailing slash
    3. \n
  3. ตรวจสอบ HTTP method — GET /memory กับ POST /memory ต่างกัน
    4. \n
\n

API call ส่งกลับ 429

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. เปลี่ยนไปใช้ header auth (ไม่จำกัดอัตรา):
    # Don't\ncurl ".../memory/recall?key=mk_..."\n\n# Do\ncurl -H "Authorization: Bearer mk_..." .../memory/recall
    2. \n
  2. รอ Retry-After วินาที หากต้องใช้ ?key=
    3. \n
\n

ดู Rate Limits

\n

การค้นหา memory ส่งกลับไม่มีผลลัพธ์

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. ตรวจสอบ memory มีอยู่: GET /memory/recall
    2. \n
  2. ตรวจสอบไวยากรณ์ search — FTS5 มีไวยากรณ์เฉพาะ
    3. \n
  3. ลอง query ที่ง่ายกว่า — ?q=docker แทน ?q=docker+swarm+deployment
    4. \n
  4. ใช้ semantic search สำหรับ query เชิงแนวคิด: GET /memory/semantic-search?q=...
    5. \n
\n

ดู FTS5 Search

\n

memory ไม่คงอยู่

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. ตรวจสอบ Mind Key เดียวกัน — key ต่างกัน = mind ต่างกัน
    2. \n
  2. ตรวจสอบ response — POST ส่งกลับ { "id": "mem_...", "status": "stored" }
    3. \n
  3. ลอง GET /memory (รายการ JSON) แทน /memory/recall (text)
    4. \n
  4. ตรวจสอบ filter — ?category= หรือ ?tag= อาจซ่อนไว้
    5. \n
\n

tool ไม่ปรากฏใน Claude Desktop

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. รีสตาร์ท Claude Desktop ให้เต็มรูปแบบ (Cmd+Q)
    2. \n
  2. ตรวจสอบ config file เป็น JSON ที่ถูกต้อง
    3. \n
  3. ตรวจ Node.js 18+ ติดตั้ง
    4. \n
  4. รัน MCP ด้วยตนเอง: npx -y synapse-mcp-api@latest
    5. \n
  5. ตรวจ log: ~/Library/Logs/Claude/mcp.log
    6. \n
\n

ดู MCP Troubleshooting

\n

Synapse ออฟไลน์

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. ตรวจสอบอินเทอร์เน็ต — ลองเว็บไซต์อื่น
    2. \n
  2. ตรวจสอบสุขภาพ Synapse: curl https://synapse.schaefer.zone/health
    3. \n
  3. รอ — อาจเป็น outage ชั่วคราวหรือ deployment
    4. \n
  4. ตรวจสอบหน้าสถานะ (หากมี)
    5. \n
\n

สำหรับ self-host: ตรวจสอบสถานะ Docker container, การเชื่อมต่อฐานข้อมูล

\n

ข้อผิดพลาดฐานข้อมูล

\n

อาการ

\n\n

วิธีแก้

\n

สำหรับ self-host:

\n
    \n
  1. ตรวจ PostgreSQL รันอยู่: docker ps | grep postgres
    2. \n
  2. ตรวจ DATABASE_URL ใน env
    3. \n
  3. ตรวจ migration: npm run migrate:check
    4. \n
  4. ตรวจพื้นที่ดิสก์: df -h
    5. \n
\n

สำหรับโฮสต์: รายงานไปยัง support

\n

Webhook ไม่ทำงาน

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. ตรวจสอบ URL เข้าถึงได้: curl -X POST your-url -d '{}'
    2. \n
  2. ตรวจสอบ filter event — memory.* ตรงทุก memory event
    3. \n
  3. ทดสอบ webhook: POST /webhooks/:id/test
    4. \n
  4. ตรวจ webhook เปิดใช้งาน: GET /webhooks/:id
    5. \n
  5. ตรวจสอบ SSL — Synapse ต้องการ HTTPS ที่ถูกต้องสำหรับ webhook URL
    6. \n
\n

ดู Webhooks API

\n

Cron job ไม่รัน

\n

อาการ

\n\n

วิธีแก้

\n
    \n
  1. ตรวจไวยากรณ์ schedule — ต้องเป็น 5-field cron หรือ integer วินาที
    2. \n
  2. ตรวจ endpoint ได้รับอนุญาต — ต้องเป็น http(s), ไม่มี private IP
    3. \n
  3. ตรวจ job เปิดใช้งาน: GET /cron
    4. \n
  4. รอเวลาที่ตั้งเวลาไว้ถัดไป — cron ไม่ใช่ทันที
    5. \n
\n

ดู Cron & Scheduler

\n

ต้องการความช่วยเหลือเพิ่มเติม?

\n
    \n
  1. ตรวจเอกสารที่มี: https://synapse.schaefer.zone/docs
    2. \n
  2. ค้นหาเอกสาร: GET /docs/search?q=your+question
    3. \n
  3. เปิด issue: https://gitlab.com/schaefer-services/synapse/-/issues
    4. \n
  4. ติดต่อ: ดูหน้า /support
    5. \n
\n

ขั้นตอนถัดไป

\n\n","urls":{"html":"/docs/faq/troubleshooting","text":"/docs/faq/troubleshooting?format=text","json":"/docs/faq/troubleshooting?format=json","llm":"/docs/faq/troubleshooting?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}