Skip to content

Commit eca84d4

Browse files
committed
Add FAQ about failing builds
1 parent 2b85c92 commit eca84d4

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

README.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,11 @@ Make sure the path for [`cache_img`](#1-cache_img) is correct. Aand you're done!
3434

3535
You can read Netlify's documentation about Plugins here: https://docs.netlify.com/configure-builds/build-plugins/
3636

37+
**Note**: If your builds are failing, the version of Node
38+
you're using is probably not supported by Netlify.
39+
Try Node v16.x.x.
40+
See the [FAQs section](#my-builds-are-failing) for more info.
41+
3742
## Documentation
3843

3944
### 1. `cache_img`
@@ -95,6 +100,32 @@ use `rimraf '_site/!(img)'`.
95100
If they are in a subdirectory, say `_site/assets/images`,
96101
use `rimraf '_site/!(assets)' '_site/assets/!(images)'`.
97102

103+
### My builds are failing
104+
105+
If your build fails with
106+
```bash
107+
11:37:10 AM: Uncaught exception, the process will now terminate…
108+
11:37:10 AM: Error: Unable to deserialize cloned data due to invalid or unsupported version.
109+
11:37:10 AM: at parseChannelMessages (node:internal/child_process/serialization:97:20)
110+
11:37:10 AM: at parseChannelMessages.next (<anonymous>)
111+
11:37:10 AM: at Pipe.channel.onread (node:internal/child_process:619:18)
112+
```
113+
114+
The version of Node you're using is probably not supported by Netlify.
115+
116+
Try setting Node version to 16.x
117+
118+
```bash
119+
echo "16" > .nvmrc
120+
```
121+
122+
More info about this error:
123+
- https://answers.netlify.com/t/netlify-build-cache-error/78115/4
124+
- https://answers.netlify.com/t/build-failing-after-upgrade-to-node-18/75774
125+
126+
See this guide for more ways to set Node versions:
127+
https://docs.netlify.com/configure-builds/manage-dependencies/
128+
98129
### Are there any Benchmarks?
99130
Yes!
100131

0 commit comments

Comments
 (0)