errors

package

v0.24.0 Latest Latest Go to latest Published: Oct 16, 2026 License: Apache-2.0 Imports: 1 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/pigeonbox/core

Links

Open Source Insights

Documentation ¶

Overview ¶

shareblocked.go 分享管控拒绝态错误（治理状态机的 typed error 词汇表）。

历史：app/share.ShareBlockedError 与 app/anonymous.BlockedError 曾各持一份逐字相同的实现（消息文案与 errcode 映射同款，状态常量还一个用 model 常量一个用字面量，已有漂移），2026-10-10 合并至此；两域以类型别名消费， handler 侧 errors.As / resp.NewTypedError 用法不变。

Index ¶

Constants
func GetErrorCode(err error) int
func GetMessage(code int) string
func IsAppError(err error) bool
type AppError
- func (e *AppError) Error() string
- func (e *AppError) Unwrap() error
type ShareBlocked
- func (e *ShareBlocked) ErrCode() int
- func (e *ShareBlocked) Error() string

Constants ¶

View Source

const (
	CodeSuccess      = errcode.CodeSuccess
	CodeBadRequest   = errcode.CodeInvalidParam
	CodeUnauthorized = errcode.CodeUnauthorized
	CodeForbidden    = errcode.CodeForbidden
	CodeNotFound     = errcode.CodeNotFound
	// CodeConflict：contracts v0.15.1 起直接引用 errcode 常量（v0.22.0 tag 时该常量
	// 未发布曾本地同值，随 deps 仪式切回引用，值不变）。
	CodeConflict           = errcode.CodeConflict
	CodeInternalError      = errcode.CodeInternal
	CodeServiceUnavailable = errcode.CodeUnavailable
	CodeTooManyRequests    = errcode.CodeRateLimit
)

统一错误码（2026-10-15）：legacy 1001-1008 退役，常量名保留为 errcode 别名重钉到 contracts/errcode 对应值——全部经由常量的发射点一次性迁移，无需改任何调用方。wire 上旧值不再出现（破坏性变更，随主/次版本公告，对照表见文档站 error-codes 页）：

1001 → 10001 InvalidParam
1002 → 10002 Unauthorized
1003 → 10003 Forbidden
1004 → 10004 NotFound
1005 → 10016 Conflict（errcode 新增）
1006 → 10008 Internal
1007 → 10006 Unavailable
1008 → 10005 RateLimit

View Source

const (
	ShareStatusBlocked       = "blocked"
	ShareStatusPendingReview = "pending_review"
)

分享治理状态字面量。pkg 层不得 import repo（架构守卫规则 1），故此处独立定义并与 repo/db/model 的同名常量对齐——app 层测试钉死防漂移断言。

Variables ¶

This section is empty.

Functions ¶

func GetErrorCode ¶

func GetErrorCode(err error) int

func GetMessage ¶

func GetMessage(code int) string

func IsAppError ¶

func IsAppError(err error) bool

Types ¶

type AppError ¶

type AppError struct {
	Code    int
	Message string
	Cause   error
}

func BadRequest ¶

func BadRequest(message string) *AppError

func Conflict ¶

func Conflict(message string) *AppError

func Forbidden ¶

func Forbidden(message string) *AppError

func InternalError ¶

func InternalError(message string) *AppError

func New ¶

func New(code int, message string) *AppError

func NotFound ¶

func NotFound(message string) *AppError

func Unauthorized ¶

func Unauthorized(message string) *AppError

func Wrap ¶

func Wrap(code int, message string, cause error) *AppError

func (*AppError) Error ¶

func (e *AppError) Error() string

func (*AppError) Unwrap ¶

func (e *AppError) Unwrap() error

type ShareBlocked ¶ added in v0.15.1

type ShareBlocked struct {
	Status string
}

ShareBlocked 分享处于管控拒绝态（管理员禁用 / 待审核）。 handler 侧按 ErrCode 透传（20012 blocked / 20013 pending_review）。

func (*ShareBlocked) ErrCode ¶ added in v0.15.1

func (e *ShareBlocked) ErrCode() int

func (*ShareBlocked) Error ¶ added in v0.15.1

func (e *ShareBlocked) Error() string

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL