Skip to content

Apache APISIX HTTPS Redirect Not Working

DodaTech Updated 2026-06-24 2 min read

You encounter a apisix configuration issue that prevents your workflow from completing. This guide walks through the fix step by step.

Wrong ❌

{
  "plugins": {
    "key-auth": {},
    "keycloak-auth": {},
    "redirect": { "http_to_https": true }
  },
  "uri": "/*"
}

Wrong Output

Requests to HTTP are processed by auth plugins before the redirect. Auth returns 401 before the 301 redirect.
{
  "plugins": {
    "redirect": { "http_to_https": true }
  },
  "uri": "/*"
}
# Redirect route should be separate from the API route

Right Output

HTTP requests receive 301 redirect to HTTPS. Browsers redirect automatically. No auth processing on HTTP.

Prevention

  • Place redirect plugin first in plugin order or on a separate route.
  • Do not combine redirect with auth plugins on the same route.
  • Use a separate redirect route with higher priority.
  • Test with HTTP curl -L to follow redirects.
  • Use 301 for permanent redirects, 302 for temporary.

DodaTech applies similar defensive patterns across Doda Browser, DodaZIP, and Durga Antivirus Pro infrastructure for production reliability.

Common Mistakes with redirect https

  1. Forgetting deriving (Show, Eq) on custom data types needed for debugging
  2. Placing the wildcard pattern first in case expressions, making all subsequent patterns unreachable
  3. Using head and tail instead of pattern matching, causing runtime errors on empty lists

These mistakes appear frequently in real-world APISIX code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

**Q: What is the most common cause of this apisix error?**

A: Configuration drift between environments and version mismatches are the top causes. Always verify both before deeper troubleshooting.

Q: Can this error affect production traffic?

A: Yes. Depending on whether it occurs in the control plane or data plane, it can block all traffic or cause silent failures.

Q: How do I monitor for this error in production?

A: Set up log-based alerts for the error signature shown above. Most monitoring platforms support pattern matching on log entries.

Q: Is there a quick rollback procedure?

A: Revert the configuration change and restart the service. For data-plane errors, replay affected records from the source of truth.


This quick fix is part of the DodaTech infrastructure engineering series. Learn more at DodaTech tutorials.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro