ErrLookup › gofr-dev/gofr

gofr-dev/gofr

An opinionated GoLang framework for accelerated microservice development. Built in support for databases and observability. · Go · 432 source files

Analyzed at 187eb24962 on 2026-09-01. 188 documented errors.

Code / Message	Type	Severity	Tags
%w: deleting document: %w	exception	error	jwt, rbac, configuration
%w: %s	exception	error	jwt, rbac, claims
index name cannot be empty	validation	error	jwt, rbac, parsing
document ID cannot be empty	validation	error	jwt, rbac, parsing
query cannot be empty	validation	error	jwt, rbac, claims
operations cannot be empty	validation	error	jwt, rbac, type-mismatch
elasticsearch health check failed	exception	error	jwt, rbac, index-out-of-range
elasticsearch operation error	exception	error	jwt, rbac, type-mismatch
error marshaling data	exception	error	jwt, rbac, claims
error parsing response	exception	error	jwt, rbac, claims
invalid elasticsearch response	exception	error	elasticsearch, http-response, server-error
error encoding operation	exception	error	elasticsearch, json-encoding, bulk-api
%w: settings: %w	exception	error	elasticsearch, json-marshal, create-index
%w: creating index: %w	exception	critical	elasticsearch, network, connection, timeout
%w: %s	exception	error	elasticsearch, create-index, http-response
%w: deleting index: %w	exception	critical	elasticsearch, network, connection, delete-index
%w: query: %w	exception	error	elasticsearch, json-marshal, search
%w: executing search: %w	exception	critical	elasticsearch, network, timeout, search
%w: %w	exception	error	elasticsearch, json-parsing, response-decoding, golang
%w: executing bulk: %w	exception	critical	elasticsearch, network, bulk-api, connection
errors.Wrap(e.Err, e.Message).Error()	exception	warning	database, error-wrapping, golang, error-formatting
invalid Azure configuration: share name is required	validation	error	azure, configuration, azure-files, missing-config
invalid Azure configuration: account name is required	validation	error	azure, configuration, azure-files, missing-config
invalid Azure configuration: account key is required	validation	error	azure, configuration, credentials, azure-files
azure config is nil	validation	error	azure, configuration, nil-config, azure-files
failed to create directory %q: %w	error_code	error	azure, storage, directory, mkdir
`errFileNotOpenForReading` file not open for reading	error_code	error	file, read, open-mode, gofr
failed to generate signed URL for %q: %w	exception	error	go, signed-url, file-storage, error-wrapping
invalid FTP configuration: host and port are required	error_code	error	go, ftp, configuration, validation
invalid FTP provider	error_code	error	go, ftp, provider, validation
FTP config is nil	error_code	error	go, ftp, nil-config, initialization
FTP client is not initialized	error_code	error	go, ftp, connection, lifecycle
object name is empty	error_code	error	go, ftp, validation, arguments
invalid offset: must be >= 0	validation	error	go, ftp, range-read, validation
source and destination names cannot be empty	validation	error	go, ftp, copy, validation
source and destination are the same	validation	error	go, ftp, copy, validation
failed to create reader	error_code	error	go, ftp, io, network
failed to create writer	error_code	error	ftp, io, object-storage
object not found	error_code	error	ftp, not-found, object-storage
failed to get object attrs	error_code	error	ftp, metadata, object-storage
failed to delete object	error_code	error	ftp, delete, permissions
failed to list objects	error_code	error	ftp, listing, network
failed to list directory	error_code	error	ftp, listing, directory
writer already closed	error_code	error	ftp, io, lifecycle
invalid FTP configuration: host and port are required	error_code	error	ftp, configuration, validation
failed to dial FTP server %q: %w	exception	error	ftp, network, connection, timeout
FTP login failed for user %q: %w	exception	error	ftp, authentication, credentials
%w %q: %w	exception	error	ftp, file-not-found, storage
%w for %q: %w	exception	error	ftp, network, reader
%w (got: %d)	exception	error	validation, ftp, range-request
%w for %q at offset %d: %w	exception	error	ftp, network, range-request
%w: %q	exception	error	ftp, file-not-found, copy
failed to read source object %q: %w	exception	error	ftp, network, copy
response retrieved is nil	exception	error	s3, aws-sdk, nil-response, gofr
s3 backend did not honor the requested byte range	exception	error	s3, http-range, s3-compatible, gofr
%w: S3 file is empty	exception	error	s3, nil-response, read, gofr
%w: negative offset %d	validation	error	s3, validation, out-of-range, gofr
input should be a pointer to a string	validation	error	type-mismatch, scan, rowreader, gofr
out of range	exception	error	out-of-range, seek, validation, s3, gofr
incorrect file type	validation	error	rename, s3, validation, gofr
%w: renaming as well as moving file to different location is	validation	error	rename, s3, operation-not-permitted, gofr
%w: new filename must match the old file's type	validation	error	rename, file-type, s3, gofr
operation not permitted	exception	error	s3, operation-not-permitted, chdir, rename, gofr
organization id must not be empty	validation	error	influxdb, validation, empty-identifier, gofr
bucket id must not be empty	validation	error	influxdb, validation, empty-identifier, gofr
bucket name must not be empty	validation	error	influxdb, validation, empty-identifier, gofr
failed to fetch all organizations	exception	error	influxdb, network, api-failure, gofr
influxdb health check failed	exception	critical	influxdb, health-check, availability, gofr
File is closed	exception	error	file-io, lifecycle, gofr, datasource
out of range	exception	warning	file-io, bounds, seek, gofr
too large	exception	warning	file-io, limits, gofr
status down	exception	critical	badger, kv-store, health-check, availability, gofr
client not connected, call Connect() first	exception	error	dynamodb, kv-store, lifecycle, initialization, gofr
key not found	exception	warning	dynamodb, kv-store, key-not-found, aws
status down	exception	critical	dynamodb, health-check, aws, connectivity
failed to marshal value to JSON: %w	exception	error	json, serialization, dynamodb, kv-store
failed to unmarshal JSON: %w	exception	error	json, deserialization, dynamodb, kv-store
%w: %s	exception	warning	dynamodb, kv-store, key-not-found, aws
status down	exception	critical	nats, jetstream, health-check, connectivity
key not found	exception	warning	nats, jetstream, kv-store, key-not-found
%w: %s	exception	warning	nats, jetstream, key-not-found, kv-store
failed to get key: %w	exception	error	nats, jetstream, kv-store, connectivity
failed to set key-value pair: %w	exception	error	nats, jetstream, kv-store, write-failure
publish error	exception	error	nats, jetstream, publish, gofr
jStream is not configured	exception	error	nats, jetstream, initialization, gofr
jStream creation failed	exception	error	nats, jetstream, server-config, gofr
jStream error	exception	error	nats, jetstream, health-check, gofr
create stream error	exception	error	nats, jetstream, stream, gofr
delete stream error	exception	error	nats, jetstream, stream, gofr
get stream error	exception	error	nats, jetstream, stream, gofr
create or update stream error	exception	error	nats, jetstream, stream, gofr
handler error	exception	error	nats, jetstream, consumer, message-handler, gofr
connection error	exception	critical	nats, connection, network, gofr
unsupported db dialect; supported dialects are - mysql, post	validation	error	database, configuration, sql
failed to append CA certificate	exception	error	tls, mysql, certificates, configuration
failed to read CA certificate from %s: %w	exception	error	tls, mysql, filesystem, configuration
failed to load client certificate: %w	exception	error	tls, mtls, mysql, certificates
not connected to database	exception	error	surrealdb, connection, lifecycle
failed to connect to SurrealDB: no valid database instance	exception	critical	surrealdb, connection, configuration
both username and password must be provided	validation	error	surrealdb, authentication, configuration
no record found	exception	error	surrealdb, crud, not-found
no result found in query response	exception	warning	surrealdb, query, empty-result
unexpected result type: expected []any	exception	error	surrealdb, type-mismatch, compatibility
query error	exception	error	database, surrealdb, query, gofr
api keys list is empty	validation	error	auth, api-key, config, gofr
container is nil	validation	error	auth, nil-pointer, container, gofr
validate func is empty	validation	error	auth, validation, config, gofr
user list is empty	validation	error	auth, basic-auth, config, gofr
response writer does not support hijacking	error_code	error	http, websocket, hijack, middleware, gofr
%w: cannot hijack connection	error_code	error	http, websocket, hijack, middleware, gofr
require non-empty provider	validation	error	oauth, jwt, config, gofr
invalid interval, require a value greater than 1 second	validation	error	oauth, jwt, config, gofr
modulus is empty	validation	error	oauth, jwt, jwks, rsa, gofr
public exponent is empty	validation	error	oauth, jwt, jwks, rsa
response body is empty	validation	error	oauth, network, jwks, http
invalid URL	validation	error	oauth, url, configuration
requestsPerSecond must be positive	validation	error	rate-limiting, configuration, middleware
burst must be positive	validation	error	rate-limiting, configuration, middleware
invalid rate limiter config: %v	panic	critical	rate-limiting, panic, configuration, middleware
Could not open WebSocket connection	http	error	websocket, http, upgrade, network
unsupported interface value type	validation	error	multipart, binding, reflection
data length exceeds array capacity	validation	error	multipart, binding, array
unsupported kind	validation	error	multipart, binding, reflection
internal server error	http	error	http, handler, nil-response
file does not have read permission: %w	error_code	error	filesystem, permissions, static-files
stream source panicked	error_code	error	streaming, panic, recovery
stream source is nil	validation	error	streaming, nil-check
stream value could not be encoded	error_code	error	streaming, serialization
%w: %v	error_code	error	streaming, panic, error-wrapping
invalid certificate file	validation	critical	tls, certificate, startup, configuration
invalid key file	validation	critical	tls, private-key, startup, configuration
%w : %v	validation	critical	tls, certificate, startup, configuration
elasticsearch: %w	exception	error	elasticsearch, migration, error-wrapping
failed to record migration: %w	exception	error	elasticsearch, migration, write-failure
failed to acquire migration lock	exception	error	migration, distributed-lock, redis
failed to release migration lock	exception	error	migration, distributed-lock, redis
failed to refresh MongoDB lock: lock lost or stolen	exception	error	mongodb, migration, distributed-lock
mongo: %w	exception	error	mongodb, migration, error-wrapping
failed to create migration file: received nil file handle	exception	error	opentsdb, migration, filesystem
failed to create migration directory %q: %w	exception	error	opentsdb, migration, filesystem, permissions
unexpected error stating migration file: %w	exception	error	opentsdb, migration, filesystem, permissions
failed to open existing migration file: %w	exception	error	opentsdb, migration, filesystem, permissions
sql: %w	exception	error	sql, migration, database, gofr
failed to execute migration query	exception	error	surrealdb, migration, database, gofr
%w: %s: %w	exception	error	surrealdb, migration, ddl, gofr
surrealdb: %w	exception	error	surrealdb, migration, database, gofr
unsupported config file format	validation	error	rbac, config, validation, gofr
endpoint must specify requiredPermissions (or be public)	validation	error	rbac, authorization, config, gofr
wildcard pattern '/*' is not supported, use mux patterns ins	validation	error	rbac, config, routing, gofr
regex pattern '^...$' is not supported, use mux patterns ins	validation	error	rbac, config, routing, migration, gofr
regex pattern is not supported, use mux patterns instead	validation	error	rbac, config, routing, gofr
failed to read RBAC config file %s: %w	exception	error	rbac, config, filesystem, gofr
failed to parse YAML config file %s: %w	validation	error	go, yaml, config, rbac, parse-error
failed to parse JSON config file %s: %w	validation	error	go, json, config, rbac, parse-error
unsupported config file format: %s (supported: .json, .yaml,	validation	error	go, config, rbac, file-format, unsupported
invalid RBAC config: %w	validation	error	go, rbac, config, validation
failed to process unified config: %w	validation	error	go, rbac, config, processing
endpoint[%d]: %w: %s	validation	error	go, rbac, config, validation, permissions
endpoint[%d]: invalid mux pattern: %w	validation	error	go, rbac, mux, routing, validation
endpoint[%d]: %w: %s. Examples: /api/{resource} for single-l	validation	error	go, rbac, routing, wildcard, validation
endpoint[%d]: %w: %s. Example: /api/users/{id:[0-9]+} instea	validation	error	go, rbac, routing, regex, validation
endpoint[%d]: %w: %s. Example: /api/users/{id:[0-9]+}	validation	error	go, rbac, routing, regex, validation
invalid array index	exception	error	go, jwt, rbac, configuration
claim key not found	exception	error	go, jwt, rbac, claims
claim value is not an array	exception	error	go, jwt, rbac, claims
array index out of bounds	exception	error	go, jwt, rbac, claims
invalid claim structure	exception	error	go, jwt, rbac, claims
authorization error	exception	info	go, rbac, tracing, security
Unauthorized: Missing or invalid role	http	error	go, rbac, http, unauthorized
Forbidden: Access denied	http	warning	go, rbac, http, forbidden
failed to extract role from JWT: %w	exception	error	go, jwt, rbac, claims
unable to connect to server at host	exception	error	circuit-breaker, network, resilience, http-client
unexpected result type from circuit breaker	exception	error	circuit-breaker, http-client, type-assertion, resilience
MaxIdleConns cannot be negative	validation	error	http-client, configuration, connection-pool, validation
MaxIdleConnsPerHost cannot be negative	validation	error	http-client, configuration, connection-pool, validation
IdleConnTimeout cannot be negative	validation	error	http-client, configuration, connection-pool, validation
%w, got: %d	validation	error	http-client, configuration, connection-pool, validation
%w, got: %v	validation	error	http-client, configuration, connection-pool, validation
token file is empty	exception	error	kubernetes, auth, file-io, config
no token available	exception	error	auth, bearer-token, kubernetes
authorization header already set on request	exception	error	auth, http-headers, conflict
failed to read token from %s: %w	exception	critical	kubernetes, auth, startup, file-io
errMessage (dynamic credential validation error)	http	warning	testing, oauth, mock-server, auth
Unable to generate token	http	error	testing, oauth, mock-server, internal-error
failed to read random bytes: %w	exception	error	crypto, entropy, testing, environment
requests must be greater than 0 per configured time window	validation	error	rate-limiting, config, validation
burst must be greater than requests per window	validation	error	rate-limiting, config, validation
unexpected Redis result type	exception	error	redis, rate-limiting, type-mismatch