testing-knowledge

Call Mock(targetFunc).Return(value).Build() to replace a function's behavior, typically inside a PatchConvey block so the mock is released automatically after the test. Remember to run tests with -gcflags="all=-l -N" to disable inlining.

Use MockGeneric instead of Mock for generic functions and methods, specifying the instantiated type such as MockGeneric(FooGeneric[string]).Return(value).Build(). The standard Mock API does not handle generics.

The most common cause is not disabling inlining and compiler optimizations; run tests with -gcflags="all=-l -N". Also verify you called .Build(), matched pointer versus value receivers correctly, and used MockGeneric for generics.

Yes, Mockey is designed to work with goconvey via PatchConvey, which scopes mocks so they are automatically released when the block exits. This prevents mock leakage between test cases.

This error occurs when inlining is not disabled, the target function is too short to patch, or another tool already mocked it. Disable optimizations with -gcflags flags or use MockUnsafe for very short functions.

Mockey supports Go 1.13 and later on Mac OS, Linux, and Windows, across AMD64 and ARM64 architectures. It is widely used across ByteDance repositories for unit testing.