Go: tls: first record does not look like a TLS handshake (HTTP server spoken to with HTTPS)
A Go TLS client or server received plain HTTP bytes instead of a TLS handshake.
tls: first record does not look like a TLS handshakehttp: TLS handshake error from: tls: first record does not look like a TLS handshakeClient sent an HTTP request to an HTTPS server.tls: oversized record received Meaning
Either the client uses https:// for a plain HTTP endpoint, or a browser/client sent HTTP to a Go ListenAndServeTLS port. Use the right scheme, serve TLS on the right port, or put a redirect listener on the plain port.
Common causes
- HTTPS client to an HTTP-only port
- HTTP request to a TLS listener
- Proxy speaking HTTP to a TLS backend
- Mixed ports in config
- Wrong scheme in the URL
⚡ Quick fix
- Fix the URL scheme/port
- Add a separate HTTP listener that redirects to HTTPS
- Check
ListenAndServevsListenAndServeTLS
Detailed fix by platform
Go
- bash
go http.ListenAndServe(":80", http.HandlerFunc(redirectToHTTPS)) http.ListenAndServeTLS(":443", "cert.pem", "key.pem", mux)
How to diagnose
- Scheme — Matches?
- Listener — TLS or plain?
- Redirect — Present?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
Most viewed in SSL / TLS
- HTTPSConnectionPool: Max retries exceeded (SSLError) Python requests: HTTPSConnectionPool(host='api.example.com', port=443): Max retries exceeded with url: /v1 (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] ...')))
- DST Root CA X3 expired (old clients fail) Old clients: certificate has expired — Let's Encrypt chain uses expired DST Root CA X3 (OpenSSL 1.0.x, Android < 7.1.1)
- Keystore was tampered with, or password was incorrect Java keytool: java.io.IOException: Keystore was tampered with, or password was incorrect
Other ways to find it
Where this error sits
Origin: Network. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 18 Nov 2026