http-swagger/v2 does not support swag/v2 - Internal Server Error

[arantesxyz]

$ swag --version
Swag version:  v2.0.0
swag version v2.0.0

go.mod

go 1.24.2

require (
	github.com/go-chi/chi/v5 v5.2.2
	github.com/swaggo/http-swagger/v2 v2.0.2
	github.com/swaggo/swag/v2 v2.0.0-rc4
)

Generating the spec with swag/v2:

$ swag init --dir ./internal/handlers --v3.1

We get the following output:

docs/docs.go

// Code generated by swaggo/swag. DO NOT EDIT.

package docs

import "github.com/swaggo/swag/v2"

// ...

Then use http-swagger/v2 to render the page
routes.go

package server

import _ "app/docs"
import httpSwagger "github.com/swaggo/http-swagger/v2"

// ...
func registerRoutes(r *chi.Mux) {
    r.Get("/docs", func(w http.ResponseWriter, r *http.Request) {
    	http.Redirect(w, r, "/docs/", http.StatusFound)
    })
    
    r.Get("/docs/*", httpSwagger.Handler(
    	httpSwagger.URL("/docs/doc.json"),
    	httpSwagger.Layout(httpSwagger.BaseLayout),
    ))
}

And then we get the following error:

But if we manually go to docs/docs.go and update the import to import "github.com/swaggo/swag" (removing the v2), everything works as expected.

[arantesxyz]

I know http-swagger/v2 is not using swag/v2 (

http-swagger/go.mod

Line 8 in c7b1da0

github.com/swaggo/swag v1.8.1

).

But do we have plans on upgrading that?

In case someone is having the same issue, my temporary solution is just to manually remove it:

generate-docs:
	@swag init --dir ./internal/handlers --v3.1
	@sed -i '' 's|swag/v2|swag|' docs/docs.go # https://github.com/swaggo/http-swagger/issues/132