Skip to content

Commit d7645ec

Browse files
added troubleshooting for 431 (#2373)
Fixes: https://github.tools.sap/cap/cdsnode/issues/2588 --------- Co-authored-by: Johannes Vogel <31311694+johannes-vogel@users.noreply.github.com>
1 parent 5cf619b commit d7645ec

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

get-started/get-help.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,13 @@ Ensure that database transactions are either committed or rolled back. This can
166166

167167
If you're using [@sap/hana-client](https://www.npmjs.com/package/@sap/hana-client), verify that the environment variable [`HDB_NODEJS_THREADPOOL_SIZE`](https://help.sap.com/docs/SAP_HANA_CLIENT/f1b440ded6144a54ada97ff95dac7adf/31a8c93a574b4f8fb6a8366d2c758f21.html?version=2.11) is adjusted appropriately. This variable specifies the amount of workers that concurrently execute asynchronous method calls for different connections.
168168

169+
### Why are requests rejected with `431` and not logged?
170+
171+
| | Explanation |
172+
|--------------|----------------------------------------------------------------------------------------------------------------------|
173+
| _Root Cause_ | `431` occurs when the size of the request headers exceeds the maximum limit configured in the Node.js HTTP server. In this case, the Node.js HTTP server rejects the request during the initial parsing phase before it reaches CAP. Therefore, the request is not logged by the application. |
174+
| _Solution_ | Inspect the request headers and check their size. If large headers are required and cannot be reduced, increase the maximum allowed HTTP header size in Node.js by setting the following environment variable `NODE_OPTIONS="--max-http-header-size=65536"` |
175+
169176

170177
### Why are requests rejected with `502`?
171178

0 commit comments

Comments
 (0)