ProxymanApp / ProxymanApp/Proxyman
Next.js 15 server-side requests not captured — --require flag in PATH override not inherited by worker processes
@NghiaTranUIT is already working on this.
Since Mar 12, 2026.
- Dominant language
- No language data
- Stars
- 7k
- Forks
- 237
- PR merge metrics
- No merged PRs in 30d
Description
Description
After updating Proxyman to 6.6.0 (from a version ~2 months ago), server-side requests from a Next.js 15 app are no longer visible in Proxyman. Nothing else changed, same Next.js version, same Node.js version, same setup.
The PATH override (overrides/path/node) injects Proxyman's script via --require on the initial node process. However, Next.js 15 spawns child worker processes for server components and route handlers. These workers invoke node directly and don't inherit the --require flag, so Proxyman's global-agent/undici patching is never applied to the processes that actually make HTTP requests.
Steps to Reproduce
- Source the Proxyman automatic setup script in a terminal
- Start a Next.js 15 app (next dev)
- Trigger a server-side fetch (server component, API route, etc.)
- Observe that the request does NOT appear in Proxyman
Note: Plain Node.js fetch works fine: node -e "fetch('https://httpbin.org/get').then(r => r.json()).then(console.log)" does appear in Proxyman.
Current Behavior
Server-side requests made by Next.js 15 worker processes are not captured by Proxyman. The --require injection from the PATH override only applies to the initial node process, not to child workers spawned by Next.js.
Expected Behavior
All server-side requests from Next.js should appear in Proxyman, as they did before the update.
Workaround
Using NODE_OPTIONS instead of the PATH override works because it's inherited by all child processes:
NODE_OPTIONS="--require /Applications/Proxyman.app/Contents/Frameworks/ProxymanCore.framework/Versions/A/Resources/overrides/js/js.min.js" next dev
Environment
- App version: Proxyman 6.6.0
- macOS version: macOS 26.2 (Tahoe)
- Node.js: v22.16.0
- Next.js: 15.3.6
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.