اگر برنامه Postman درست کار نمی‌کند، چند مسیر اصلی برای پیدا کردن علت مشکل وجود دارد: بررسی لاگ‌ها، DevTools، وضعیت سرویس‌های Postman، تنظیمات Hardware Acceleration و اتصال شبکه.
اگر مشکل شما مربوط به نصب یا به‌روزرسانی Postman است، بهتر است راهنمای جداگانه رفع مشکل نصب Postman را هم بررسی کنید.
پیدا کردن لاگ‌های Postman
Postman هنگام بروز خطا، پیام‌های لاگ را ذخیره می‌کند. این لاگ‌ها اطلاعاتی درباره فعالیت‌های اخیر برنامه دارند و برای عیب‌یابی بسیار کمک‌کننده‌اند.
برای دسترسی به لاگ‌ها، Postman را باز کنید و بر اساس سیستم‌عامل خود این مسیر را بروید:
- macOS: مسیر View > Developer > View Logs in Finder
- Windows: مسیر View > Developer > View Logs in Explorer
- Linux: مسیر View > Developer > View Logs in File Manager
اگر برای پشتیبانی Postman درخواست ثبت می‌کنید، فایل لاگ را به درخواست خود پیوست کنید تا تیم پشتیبانی راحت‌تر مشکل را بررسی کند.
باز کردن DevTools Console
DevTools Console پیام‌های داخلی مربوط به اجرای Postman را نشان می‌دهد. برای باز کردن آن، مسیر View > Developer > Show DevTools (Current View) را انتخاب کنید. در پنجره DevTools وارد تب Console شوید تا لاگ‌های Debug برنامه را ببینید.
بررسی وضعیت سرویس Postman
گاهی مشکل از برنامه شما نیست و سرویس‌های Postman دچار اختلال، کندی یا نگهداری موقت هستند. برای بررسی این مورد، صفحه وضعیت Postman را در status.postman.com ببینید.
Hardware Acceleration
Postman برای سریع‌تر نمایش دادن گرافیک برنامه، از توان پردازنده گرافیکی سیستم استفاده می‌کند. اما در بعضی سیستم‌ها، GPU، درایور یا سیستم‌عامل می‌تواند باعث مشکل‌های تصویری یا نمایش ناقص شود. در این حالت خاموش کردن Hardware Acceleration ممکن است مشکل را حل کند.
- macOS: مسیر Postman > Enable Hardware Acceleration یا Disable Hardware Acceleration
- Windows و Linux: مسیر Help > Enable Hardware Acceleration یا Disable Hardware Acceleration
بعد از تغییر این گزینه، Postman را ببندید و دوباره باز کنید. خاموش کردن Hardware Acceleration ممکن است روی کارایی یا مصرف CPU اثر بگذارد.
مشکل‌های اتصال
اگر داده‌ها بارگذاری نمی‌شوند یا پیام خطای اتصال می‌بینید، این مراحل را امتحان کنید:
- Postman را از سیستم‌عامل به‌صورت کامل ببندید.
- برنامه دسکتاپ Postman را دوباره باز کنید.
- از منوی برنامه مسیر Help > Clear Cache and Reload را اجرا کنید.
اگر مشکل ادامه داشت، حساب Postman خود را در نسخه وب بررسی کنید. اگر در نسخه وب هم مشکل اتصال دارید، VPN یا Proxy را خاموش کنید و با یک شبکه دیگر امتحان کنید.
اگر هنوز به سرورهای Postman وصل نمی‌شوید، ممکن است لازم باشد دامنه‌های Postman را در Firewall یا شبکه خود Allowlist کنید.
مسیرهای دیگر عیب‌یابی
این راهنما مخصوص مشکل‌های خود برنامه Postman است. برای مشکل‌های دیگر، باید راهنمای مربوط به همان بخش را بررسی کنید؛ مثلا مشکل در ارسال درخواست API، Monitorها، Agent Mode، WebSocket، Vault، Proxy یا مستندات API با دامنه اختصاصی.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.