Skip to content

fix: honor session cookies across HTTP client request paths - #2104

Open
Ayush7614 wants to merge 1 commit into
apify:masterfrom
Ayush7614:fix/http-client-session-cookie-correctness
Open

fix: honor session cookies across HTTP client request paths#2104
Ayush7614 wants to merge 1 commit into
apify:masterfrom
Ayush7614:fix/http-client-session-cookie-correctness

Conversation

@Ayush7614

@Ayush7614 Ayush7614 commented Jul 30, 2026

Copy link
Copy Markdown

Summary

  • Httpx: send_request / stream now send outbound session cookies the same way crawl already did (via _build_request).
  • Impit (default client): actually honors persist_cookies_per_session (was accepted but ignored), caches clients by (proxy, cookie-jar identity), and closes cached clients on cleanup/eviction.
  • Httpx fingerprints: Accept / Accept-Language / User-Agent are generated from a single fingerprint profile instead of two independent generate() calls that could mix browser profiles.

Why

context.send_request() silently dropped session cookies under Httpx, breaking auth that worked for navigation. Impit's documented persist_cookies_per_session=False never took effect because the session jar was always attached and mutated in place.

Test plan

  • tests/unit/http_clients/test_http_clients.py — full file (82 passed)
  • New coverage: send/stream cookies, persist on/off for curl/httpx/impit, single-fingerprint headers, Impit cleanup cache reset

Httpx send_request/stream now send outbound session cookies like crawl.
Impit respects persist_cookies_per_session, keys the client cache by jar
identity, and closes cached clients on cleanup. Httpx fingerprint headers
are generated from a single profile so Accept and User-Agent stay consistent.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes inconsistent cookie handling across HTTP client request paths so that session cookies are reliably sent (and optionally persisted) whether requests go through crawler navigation (crawl) or handler-level calls (send_request/stream). It also makes Httpx’s fingerprint-derived headers internally consistent by sourcing Accept, Accept-Language, and User-Agent from a single generated fingerprint profile.

Changes:

  • Httpx: send_request/stream now attach outbound session cookies via the shared request-building path (matching crawl behavior).
  • Impit: implements persist_cookies_per_session semantics, caches clients by (proxy, cookie-jar identity), and adds client closing on cleanup/eviction.
  • Tests: adds coverage for cookie sending/persistence toggles, single-fingerprint headers, and Impit cleanup cache reset.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
tests/unit/http_clients/test_http_clients.py Adds unit coverage for session cookie sending in send_request/stream, persistence on/off behavior, single-fingerprint headers, and Impit cache cleanup.
src/crawlee/http_clients/_impit.py Honors cookie persistence flag by using a resolved jar (shared vs copy), introduces client caching keyed by proxy + cookie jar identity, and closes cached clients on cleanup/eviction.
src/crawlee/http_clients/_httpx.py Ensures handler-level requests attach session cookies and derives Accept/Accept-Language/User-Agent from one fingerprint profile.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +265 to +267
# Ephemeral jars (persist_cookies_per_session=False) must not pollute / thrash the LRU cache.
cacheable = cookie_jar is None or self._persist_cookies_per_session
cache_key = self._make_cache_key(proxy_url, cookie_jar) if cacheable else None
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants