apify-common-errors

# Apify Common Errors ## Overview Quick diagnostic reference for the most common Apify errors. Covers Actor run failures, API errors, proxy problems, anti-bot blocks, and platform-specific issues. ## Prerequisites - Apify token configured - Access to Apify Console for log review ## Error Reference ### 1. Actor Run Status: FAILED ``` Status: FAILED StatusMessage: Process exited with code 1 ``` **Cause:** Unhandled exception in Actor code. **Diagnosis:** ```typescript // Check run log via API const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.run('RUN_ID').get(); console.log(run.statusMessage); // Get the run log const log = await client.run('RUN_ID').log().get(); console.log(log); // Full stdout/stderr output ``` **Fix:** Read the log, find the stack trace, fix the bug. Common causes: - Missing input validation (`Actor.getInput()` returns `null`) - Selector returns no results (page structure changed) - Unhandled promise rejection --- ### 2. Actor Run Status: TIMED-OUT ``` Status: TIMED-OUT StatusMessage: Actor timed out after 3600 seconds ``` **Cause:** Actor exceeded its configured timeout. **Fix:** ```typescript // Increase timeout when calling via client const run = await client.actor('user/actor').call(input, { timeout: 7200, // 2 hours in seconds }); // Or set in Actor configuration on platform // Console > Actor > Settings > Timeout ``` **Prevention:** Reduce workload scope or increase `maxConcurrency`. ---...