اگر هنگام اجرای performance test در Postman به مشکل خوردید، معمولاً اولین نقطه بررسی، خطاهای initialization و محدودیت‌های شبکه یا امنیتی سیستم است. این راهنما رایج‌ترین علت‌ها و مسیرهای عیب‌یابی را خلاصه می‌کند.
Initialization error
اولین بار که performance test را شروع می‌کنید، Postman در پس‌زمینه یک performance runner extension را دانلود و نصب می‌کند. این extension برای پردازش local data و اجرای تست با load بالا لازم است.
اگر محیط local، firewall سازمانی، proxy یا ابزارهای امنیتی اجازه دانلود یا نصب این extension را ندهند، ممکن است با initialization error روبه‌رو شوید. بعد از نصب موفق extension، اجرای performance testهای بعدی معمولاً به دانلود دوباره نیاز ندارد.
پیام‌های خطای رایج
در لاگ‌های Postman ممکن است پیام‌هایی شبیه این موارد ببینید:
Timeout downloading https://performance-test-artifacts.getpostman.com/...self signed certificate in certificate chainunable to get local issuer certificateAn Application Control policy has blocked this fileClient network socket disconnected before secure TLS connection was established
محل لاگ‌های Postman
- Windows:
%AppData%\Postman\logs - macOS:
~/Library/Application Support/Postman/logs - Linux:
~/.config/Postman/logs
راه‌حل‌های پیشنهادی
- Allowlist کردن دامنه Postman: اگر سازمان شما پشت firewall است، ممکن است دانلودهای پس‌زمینه block شوند. از تیم IT بخواهید دامنه
performance-test-artifacts.getpostman.comرا allowlist کند. - حل مشکل certificate در proxy: اگر proxy سازمانی SSL inspection انجام می‌دهد، Postman ممکن است certificate را معتبر نشناسد. در این حالت باید certificate سازمان را به trusted root certificates سیستم اضافه کنید؛ مثلاً در macOS Keychain.
- بررسی application control policy: بعضی ابزارهای امنیتی اجرای binaryهای ناشناس در home directory کاربر را block می‌کنند. تیم IT باید binaryهای مدیریت‌شده توسط Postman را در مسیرهای مربوط allow کند.
- بررسی لاگ نصب: در فایل
main.logsدنبال پیام‌هایی با برچسبPerformanceTestV2یا عبارتErrorبگردید. این لاگ معمولاً مشخص می‌کند مشکل از certificate، شبکه، timeout یا policy امنیتی است.
مسیرهایی که ممکن است نیاز به allow داشته باشند
- Windows:
%AppData%\Roaming\Postman\* - macOS:
~/Library/Application Support/Postman/* - Linux:
~/.config/Postman/*
اگر با این روش‌ها مشکل حل نشد، لاگ‌های Postman را آماده کنید و با Postman support یا تیم IT سازمان بررسی کنید. برای مشکل‌های سازمانی، معمولاً داشتن پیام خطای دقیق و زمان رخداد، روند عیب‌یابی را سریع‌تر می‌کند.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.