EvaluationSnapshotNamespaceStream 'environment: "default" not found errors' when upgrading to 2.3.0

[darrenclark]

We tried upgrading from 2.1.0 -> 2.3.0 but had to rollback after seeing lots of these errors in the logs:

{"L":"INFO","T":"2025-10-28T22:08:48Z","M":"finished streaming call with code NotFound","server":"grpc","grpc.start_time":"2025-10-28T22:08:48Z","system":"grpc","span.kind":"server","grpc.service":"evaluation.ClientEvaluationService","grpc.method":"EvaluationSnapshotNamespaceStream","peer.address":"0","error":"rpc error: code = NotFound desc = environment: \"default\" not found","grpc.code":"NotFound","grpc.time_ms":0.436}
{"L":"DEBUG","T":"2025-10-28T22:08:48Z","M":"skipping authentication for server","server":"grpc","method":"/evaluation.ClientEvaluationService/EvaluationSnapshotNamespaceStream"}

I think previously it'd default to the default environment, in our case this was "dev" environment:

    environments:
      dev:
        name: dev
        directory: dev
        default: true   # <- mark dev as default environment
        storage: github-flipt-state

but now it seems to be defaulting to a environment that doesn't exist (named "default")

Possible issue / solution

I wonder if it's caused by this change: 4d02b95

Since it's no longer using GetFromContext, it no longer applies the correct defaulting logic?

I noticed that EvaluationSnapshotNamespace falls back to GetFromContext:

https://github.com/flipt-io/flipt/blob/b9d7140ffcc767558edc8d4f3acc8f67fb74ef00/internal/server/evaluation/client/server.go#L39C18-L50

Perhaps EvaluationSnapshotNamespaceStream also needs to do that fallback?

[dosubot]

The errors you're seeing after upgrading to 2.3.0 are due to a change that removed the fallback logic for environment selection in EvaluationSnapshotNamespaceStream. Previously, if no environment was specified, Flipt would use the configured default (like your dev environment). After the change, it tries to use an environment named "default", which doesn't exist in your config, causing the NotFound errors.

A recent fix was merged to address this: when "default" is requested but doesn't exist, Flipt now falls back to the actual default environment you configured (such as dev). This restores compatibility with SDKs and resolves the issue for setups like yours. You can see the details and code changes in PR #4857:

"When an environment with the key 'default' doesn't exist, the system will gracefully fall back to the actual default environment (even if it has a different key), which increases compatibility with SDKs and simplifies environment management."

If you upgrade to a version including this fix, your default environment should work as expected again.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[erka]

@darrenclark Thank you for reporting this bug. You’re right, I missed that endpoint.

[darrenclark]

No problem, will try the new release. Thanks @erka !

[markphelps]

@darrenclark thanks for reporting! I just released a new version v2.3.1 with the fix. Please let us know if it resolves the issue for you

[darrenclark]

This fixed this issue, thanks @erka @markphelps !