عیب‌یابی n8n
ابتدا مشخص کنید خطا متعلق به راه‌اندازی سرویس است یا یک اجرای workflow. برای اولی لاگ استقرار و لاگ جاری در پنل، برای دومی Executions و خروجی node شکست‌خورده را بررسی کنید.
| نشانه | بررسی و راه‌حل |
|---|---|
| برنامه باز نمی‌شود یا 502 می‌دهد | وضعیت سرویس، آخرین استقرار، لاگ شروع و مصرف منابع را بررسی کنید؛ ابتدا تغییر اخیر را پیدا کنید. |
| فقط اجرای دستی کار می‌کند | workflow را Publish/Activate کنید؛ برای webhook از Production URL و برای Schedule Trigger از timezone صحیح استفاده کنید. |
| webhook با 404 پاسخ می‌دهد | روش HTTP، آدرس کپی‌شده، فعال‌بودن listener تست یا انتشار production را بررسی کنید؛ Test URL دائمی نیست. |
| URL دارای localhost یا HTTP است | متغیرهای آدرس عمومی و HTTPS را بررسی کنید؛ متغیر webhook وابسته به نسخه است. |
| تلگرام timeout می‌دهد | اتصال از سرور n8n را بررسی کنید. برای سرویس ایران، کلودیوا در موقعیت خارجی را انتخاب کنید. |
| تلگرام فقط در تست یا فقط در production پیام می‌گیرد | token مشترک تنها یک webhook دارد؛ bot تست را جدا کنید و production را دوباره منتشر کنید. |
| تلگرام پیام را دریافت می‌کند ولی پاسخ نمی‌فرستد | خروجی AI و مسیر Chat ID از node اولیه، credential ارسال، طول متن و Parse Mode را بررسی کنید. |
| AI خطای 401 دارد | API Key و Header Auth باید Authorization: Bearer ... باشد؛ Token مدیریت پنل جایگزین API Key نیست. |
| AI خطای 402، 429 یا 5xx دارد | اعتبار/سقف کلید، محدودیت نرخ یا خطای موقت را در عیب‌یابی AI بررسی کنید؛ retry محدود داشته باشید. |
| مدل پیدا نمی‌شود یا فهرست خالی است | Base URL باید https://ai.chabokan.net/v1 و شناسه مدل دقیقاً مطابق پنل باشد؛ آن را در حالت ID وارد کنید. |
| خطای JSON یا expression دارید | برای body پویا، کل فیلد را Expression و یک object برگردانید؛ متن کاربر را داخل رشتهٔ JSON دستی جای‌گذاری نکنید. نمونهٔ درست |
undefined یا پاسخ اشتباه برای item می‌بینید | INPUT همان node را بخوانید؛ پاسخ HTTP شکل ورودی قبلی را ندارد. نام node مرجع و ارتباط itemها را بررسی کنید. |
| credential پس از انتقال قابل خواندن نیست | کلید اصلی رمزگذاری و دیتابیس سازگار لازم‌اند؛ کلید تازه را روی دادهٔ قدیمی جایگزین نکنید. |
| دیسک یا حافظه پر می‌شود | executionها، فایل‌های باینری، پردازش موازی و اندازهٔ batch را بررسی کنید؛ سیاست نگهداری را تنظیم کنید. |
| callback OAuth گوگل رد می‌شود | envهای دامنهٔ شخصی و ثبت Redirect URI در Google Cloud را بررسی کنید؛ محدودیت حساب/کشور را هم بخوانید. |
تشخیص شبکه بدون افشای token
اگر کنسول سرویس curl دارد، درخواست زیر فقط اتصال DNS/TLS/HTTP به دامنهٔ تلگرام را بررسی می‌کند؛ token و عملیات bot ندارد:
curl --connect-timeout 10 --max-time 20 -I https://api.telegram.org
هر پاسخ HTTP لزوماً موفقیت bot نیست؛ برای آن باید credential و workflow واقعی را جدا آزمایش کنید. شکست این دستور هم به‌تنهایی اثبات فیلترینگ نیست؛ DNS، خروجی شبکه و TLS را بررسی کنید. اگر curl موجود نیست، می‌توانید یک HTTP Request بدون credential به همین دامنه بسازید و جزئیات خطا را ببینید.
برای AI ابتدا workflow دستی اتصال را اجرا کنید؛ موفقیت /models فقط دسترسی به فهرست مدل را ثابت می‌کند، نه تولید پاسخ.
اطلاعات لازم برای پیگیری
نسخه n8n، نام سرویس و موقعیت ایران/خارج، زمان وقوع، node مشکل‌دار، execution ID، کد HTTP و متن خطای پاک‌شده را ثبت کنید. API Key، bot token، کلید رمزگذاری و payload خصوصی را از تصویر و export حذف کنید. اگر نمونه می‌فرستید، ورودی ساختگی و workflow حداقلی کافی است.