Go主函数测试执行异常：init()触发致配置未找到错误

问题根源 #

你的init.go文件带有构建约束：

//go:build !test
// +build !test

这意味着当构建或测试时指定了test构建标签，该文件会被编译器排除，其中的init()函数不会执行。之前测试能正常运行，就是因为当时测试命令/环境带有test标签，init.go未被编译加载。

现在测试触发init()函数，说明当前测试运行时没有带上test标签，init.go被编译进测试程序，init()执行时因为找不到CONFIG_ID环境变量，触发log.Fatal导致测试失败。

可能的触发原因 #

• 测试运行命令丢失了-tags test参数，比如直接执行go test而不是go test -tags test。
• IDE（如GoLand）的测试配置被修改，移除了构建标签test的设置。
• 项目依赖或Go版本更新后，构建约束的解析逻辑发生变化（概率较低，新老构建约束格式同时存在是兼容的）。

解决方案 #

方案1：恢复测试时的构建标签 #

运行测试时显式指定test标签，确保init.go被排除：

go test -tags test ./...

如果用GoLand，可在测试配置的「Build Tags & Vendoring」中添加test标签，保存后重新运行测试。

方案2：重构代码实现依赖注入（推荐） #

全局变量MABES和NEXT导致测试依赖环境配置，重构handler函数，将依赖作为参数传入，彻底摆脱对init()的依赖：

修改main.go中的handler：

// 新增带参数的handler，供测试和生产调用
func handlerWithDependencies(request events.APIGatewayProxyRequest, MABES mabes.Client, NEXT next.Repository) (events.APIGatewayProxyResponse, error) {
    facilityID := request.PathParameters["facilityID"]
    if facilityID == "" {
        return events.APIGatewayProxyResponse{
            StatusCode: gohttp.StatusBadRequest,
            Headers:    http.Headers("application/problem+json"),
            Body:       problem.ServerError(fmt.Errorf("missing facilityID parameter")).ToJSONResponse(),
        }, nil
    }

    transportOrders, err := api.GetAllRawTransportOrders(facilityID, request.QueryStringParameters, MABES, NEXT)
    b, err := json.Marshal(transportOrders)
    if err != nil {
        log.Errorln(err)

        if errors.Is(errors.NEXTRead, err) {
            return events.APIGatewayProxyResponse{
                StatusCode: gohttp.StatusOK,
                Headers:    http.Headers("application/json"),
                Body:       fmt.Sprintf(`{"data":%s}`, string(b)),
            }, nil
        }

        return events.APIGatewayProxyResponse{
            StatusCode: gohttp.StatusInternalServerError,
            Headers:    http.Headers("application/problem+json"),
            Body:       problem.ServerError(err).ToJSONResponse(),
        }, nil
    }

    return events.APIGatewayProxyResponse{
        StatusCode: gohttp.StatusOK,
        Headers:    http.Headers("application/json"),
        Body:       fmt.Sprintf(`{"data":%s}`, string(b)),
    }, nil
}

// 原handler保持不变，供lambda调用
func handler(request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
    return handlerWithDependencies(request, MABES, NEXT)
}

修改main_test.go中的测试，直接调用handlerWithDependencies并传入mock依赖：

func TestHandleRequest(t *testing.T) {
    t.Run("should return the TransportOrders", func(t *testing.T) {
        req := events.APIGatewayProxyRequest{
            PathParameters: map[string]string{
                "facilityID": "11", // 修正原测试中参数key不匹配的问题
            },
        }
        timeStamp, _ := time.Parse(time.RFC3339, time.Now().Format(time.RFC3339))
        sofa1 := next.SofaTransferModel{}
        sofa1.Phase = "1"
        sofa1.PartKey.PartCode = "abcd"
        sofa1.PartKey.DispatcherFacility = "11"
        sofa1.PartKey.UsageCode = "01"
        sofa1.Storage.Number = "00315"
        sofa1.Shipment.RequestedArrivalDate = timeStamp.String()
        transportOrders := make([]next.SofaTransferModel, 0)
        transportOrders = append(transportOrders, sofa1)

        getAllRawTransportOrdersCalls := 0
        api.GetAllRawTransportOrders = func(facilityID string, params map[string]string, MABES mabes.Client, NEXT next.Repository) (next.SofaTransferObjects, error) {
            getAllRawTransportOrdersCalls++
            return transportOrders, nil
        }

        // 直接调用带参数的handler，传入空的mock实例
        res, err := handlerWithDependencies(req, nil, nil)
        
        assert.Equal(t, 1, getAllRawTransportOrdersCalls)
        assert.NoError(t, err)
        assert.Equal(t, http.StatusOK, res.StatusCode)

        assert.True(t, strings.Contains(res.Body, transportOrders[0].PartKey.PartCode))
        assert.True(t, strings.Contains(res.Body, transportOrders[0].Storage.Number))
    })
}

方案3：在init()中添加测试环境判断（不推荐） #

如果暂时无法重构，可在init()中检查是否为测试环境，跳过配置加载逻辑：

import "testing"

func init() {
    // 检查是否为测试模式
    if testing.Testing() {
        return
    }

    // 原有的配置加载逻辑...
}

此方法会让生产代码和测试逻辑耦合，不推荐长期使用。

内容的提问来源于stack exchange，提问作者SamD