From ef12abe762efae28667455136676fdd4cd6f9c88 Mon Sep 17 00:00:00 2001 From: Clay Date: Tue, 29 Nov 2022 17:13:05 -0800 Subject: [PATCH 1/4] Troubleshooting issues with self-signed SSL certs --- docs/guide/troubleshooting.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 198c1ef4043b27..69428ed23730b5 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -51,6 +51,24 @@ If the above steps don't work, you can try adding `DefaultLimitNOFILE=65536` as Note that these settings persist but a **restart is required**. +### Randomly stops working + +When using a self-signed SSL certificate, Chrome ignores all caching directives and reloads the content. Vite relies on these caching directives. + +To resolve the problem use a trusted SSL cert. + +See: [Cache problems](https://helpx.adobe.com/mt/experience-manager/kb/cache-problems-on-chrome-with-SSL-certificate-errors.html), [Chrome issue](https://bugs.chromium.org/p/chromium/issues/detail?id=110649#c8) + +#### macOS + +You can install a trusted cert via the CLI with this command: + +``` +security add-trusted-cert -d -r trustRoot -k ~/Library/Keychains/login.keychain-db your-cert.cer +``` + +Or, by importing it into the Keychain Access app and updating the trust of your cert to "Always Trust." + ### 431 Request Header Fields Too Large When the server / WebSocket server receives a large HTTP header, the request will be dropped and the following warning will be shown. From f0221c69a24fac435047338cc5ac915b0fc593fb Mon Sep 17 00:00:00 2001 From: Clay Date: Tue, 29 Nov 2022 17:25:52 -0800 Subject: [PATCH 2/4] fix: fix format --- docs/guide/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 69428ed23730b5..1664979661f2ca 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -53,7 +53,7 @@ Note that these settings persist but a **restart is required**. ### Randomly stops working -When using a self-signed SSL certificate, Chrome ignores all caching directives and reloads the content. Vite relies on these caching directives. +When using a self-signed SSL certificate, Chrome ignores all caching directives and reloads the content. Vite relies on these caching directives. To resolve the problem use a trusted SSL cert. From 307453c1a8a0de49b2967918a0311b134275a2a2 Mon Sep 17 00:00:00 2001 From: Clay Date: Fri, 2 Dec 2022 17:00:48 -0800 Subject: [PATCH 3/4] Text updates --- docs/guide/troubleshooting.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 1664979661f2ca..26a03376ae14f4 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -51,7 +51,7 @@ If the above steps don't work, you can try adding `DefaultLimitNOFILE=65536` as Note that these settings persist but a **restart is required**. -### Randomly stops working +### Network requests stop loading When using a self-signed SSL certificate, Chrome ignores all caching directives and reloads the content. Vite relies on these caching directives. @@ -101,6 +101,10 @@ If HMR is not handled by Vite or a plugin, a full reload will happen. Also if there is a dependency loop, a full reload will happen. To solve this, try removing the loop. +### High number of HMR updates in console + +This can be caused by a dependency loop,. To solve this, try removing the loop. + ## Build ### Built file does not work because of CORS error From 1d24698679b0ad80341e079152d39d4c121d4bb0 Mon Sep 17 00:00:00 2001 From: Clay Date: Fri, 16 Dec 2022 14:34:44 -0800 Subject: [PATCH 4/4] Update docs/guide/troubleshooting.md Co-authored-by: Ben McCann <322311+benmccann@users.noreply.github.com> --- docs/guide/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guide/troubleshooting.md b/docs/guide/troubleshooting.md index 26a03376ae14f4..3cecb1919bb42b 100644 --- a/docs/guide/troubleshooting.md +++ b/docs/guide/troubleshooting.md @@ -103,7 +103,7 @@ Also if there is a dependency loop, a full reload will happen. To solve this, tr ### High number of HMR updates in console -This can be caused by a dependency loop,. To solve this, try removing the loop. +This can be caused by a circular dependency. To solve this, try breaking the loop. ## Build