Fix ValidatorError: code=500, message=Internal Server Error, internal=validator instance is not set in Echo

This error occurs when you call c.Validate() but have not registered a validator on the Echo instance. Echo does not include a built-in validator, so you must implement the echo.Validator interface and assign it to e.Validator. Fix it by creating a custom validator using go-playground/validator and registering it at startup.

Reading the Stack Trace

Here's what each line means:

• main.CreateOrder({0x1029e4f80, 0x14000226000}) /app/handlers/order.go:22 +0x148: The CreateOrder handler at line 22 calls c.Validate() which fails because no validator is registered on the Echo instance.
• github.com/labstack/echo/v4.(*DefaultBinder).Bind(0x14000196040, {0x102850ea0, 0x14000196060}, {0x1029e4f80, 0x14000226000}): Echo's binder successfully parses the request body, but the subsequent validation step has no validator to delegate to.
• github.com/labstack/echo/v4.(*Echo).ServeHTTP(0x14000128680, {0x1029e4f80, 0x140001c40e0}, 0x140002b4000): Echo processes the incoming request and dispatches it to the handler chain.

Common Causes

func main() {
	e := echo.New()
	// e.Validator never set
	e.POST("/api/orders", CreateOrder)
	e.Start(":8080")
}

func CreateOrder(c echo.Context) error {
	var req OrderRequest
	c.Bind(&req)
	c.Validate(&req) // panics: validator not set
	return c.JSON(200, req)
}

type MyValidator struct {
	v *validator.Validate
}

func (mv *MyValidator) Check(i interface{}) error { // wrong method name
	return mv.v.Struct(i)
}

e.Validator = &MyValidator{v: validator.New()} // compiles but doesn't satisfy interface

type OrderRequest struct {
	ProductID int     `json:"product_id"` // missing validate tag
	Quantity  int     `json:"quantity"`   // missing validate tag
}

The Fix

Implement the echo.Validator interface with go-playground/validator and assign it to e.Validator at startup. Add validate tags to struct fields for business rule enforcement. Return echo.NewHTTPError for structured error responses.

func main() {
	e := echo.New()
	e.POST("/api/orders", CreateOrder)
	e.Start(":8080")
}

func CreateOrder(c echo.Context) error {
	var req OrderRequest
	c.Bind(&req)
	c.Validate(&req)
	return c.JSON(200, req)
}

type CustomValidator struct {
	validator *validator.Validate
}

func (cv *CustomValidator) Validate(i interface{}) error {
	if err := cv.validator.Struct(i); err != nil {
		return echo.NewHTTPError(http.StatusBadRequest, formatErrors(err))
	}
	return nil
}

type OrderRequest struct {
	ProductID int `json:"product_id" validate:"required,gt=0"`
	Quantity  int `json:"quantity" validate:"required,gte=1,lte=100"`
}

func main() {
	e := echo.New()
	e.Validator = &CustomValidator{validator: validator.New()}
	e.POST("/api/orders", CreateOrder)
	e.Start(":8080")
}

func CreateOrder(c echo.Context) error {
	var req OrderRequest
	if err := c.Bind(&req); err != nil {
		return echo.NewHTTPError(http.StatusBadRequest, "invalid request body")
	}
	if err := c.Validate(&req); err != nil {
		return err
	}
	return c.JSON(http.StatusCreated, req)
}

Testing the Fix

package handlers_test

import (
	"net/http"
	"net/http/httptest"
	"strings"
	"testing"

	"github.com/go-playground/validator/v10"
	"github.com/labstack/echo/v4"
	"github.com/stretchr/testify/assert"
)

func TestCreateOrder_MissingFields(t *testing.T) {
	e := echo.New()
	e.Validator = &CustomValidator{validator: validator.New()}

	body := `{}`
	req := httptest.NewRequest(http.MethodPost, "/api/orders", strings.NewReader(body))
	req.Header.Set("Content-Type", "application/json")
	rec := httptest.NewRecorder()
	c := e.NewContext(req, rec)

	err := CreateOrder(c)
	he, ok := err.(*echo.HTTPError)
	assert.True(t, ok)
	assert.Equal(t, http.StatusBadRequest, he.Code)
}

func TestCreateOrder_ValidPayload(t *testing.T) {
	e := echo.New()
	e.Validator = &CustomValidator{validator: validator.New()}

	body := `{"product_id": 1, "quantity": 5}`
	req := httptest.NewRequest(http.MethodPost, "/api/orders", strings.NewReader(body))
	req.Header.Set("Content-Type", "application/json")
	rec := httptest.NewRecorder()
	c := e.NewContext(req, rec)

	err := CreateOrder(c)
	assert.NoError(t, err)
	assert.Equal(t, http.StatusCreated, rec.Code)
}

Run your tests:

go test ./handlers/... -v

Pushing Through CI/CD

git checkout -b fix/echo-validator-error,git add main.go handlers/order.go,git commit -m "fix: register custom validator on Echo instance with validation tags",git push origin fix/echo-validator-error

Your CI config should look something like this:

name: CI
on:
  pull_request:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
        with:
          go-version: '1.22'
      - run: go mod download
      - run: go vet ./...
      - run: go test ./... -race -coverprofile=coverage.out
      - run: go build ./...

The Full Manual Process: 18 Steps

Here's every step you just went through to fix this one bug:

1. Notice the error alert or see it in your monitoring tool
2. Open the error dashboard and read the stack trace
3. Identify the file and line number from the stack trace
4. Open your IDE and navigate to the file
5. Read the surrounding code to understand context
6. Reproduce the error locally
7. Identify the root cause
8. Write the fix
9. Run the test suite locally
10. Fix any failing tests
11. Write new tests covering the edge case
12. Run the full test suite again
13. Create a new git branch
14. Commit and push your changes
15. Open a pull request
16. Wait for code review
17. Merge and deploy to production
18. Monitor production to confirm the error is resolved

Total time: 30-60 minutes. For one bug.

go get github.com/bugstack/sdk

import "github.com/bugstack/sdk"

func init() {
  bugstack.Init(os.Getenv("BUGSTACK_API_KEY"))
}

Deploying the Fix (Manual Path)

1. Run go test ./... locally to confirm validation works.
2. Open a pull request with the validator registration.
3. Wait for CI checks to pass on the PR.
4. Have a teammate review and approve the PR.
5. Merge to main and verify in staging.

Frequently Asked Questions