Issues with Environment Switching via url (wheels 4) #3023

mikegrogan · 2026-06-11T18:34:44Z

mikegrogan
Jun 11, 2026

I've been having issues in my environment with environment switching via URL. So I installed a stock 4.0.3 on ACF 2025 latest patch and set a few parameters. Mainly in settings.cfm. Haven't had these issues in 2.5. I'm hoping I'm not missing something.

/config/environment.cfm

still has set(environment = "development");

/config/settings.cfm

set(allowEnvironmentSwitchViaUrl=true);
set(reloadPassword = "password");

I try to run this (when it's set to development) and nothing changes. Doesn't switch to testing.
http://localhost:11045?reload=testing&password=password

The only thing that works is changing the setting in environment.cfm and doing a ?reload=true&password=password, however in my last test it threw an error saying "Variable CFABORT is undefined." on the line below in dispatch.cfc. This is when I set set(environment = "testing");

https://github.com/mikegrogan/cfwheels/blob/bd2d84ae8545c8fdb3edeb61be7ec0ed67421b06/vendor/wheels/Dispatch.cfc#L315

if I set it to maintenance or development it works.

If i set it to production and run ?reload=true&password=password

Not Found
<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="utf-8">
	<meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Something went wrong</title>
	<style>
		body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; display: flex; justify-content: center; align-items: center; min-height: 100vh; margin: 0; background: ##f8f9fa; color: ##333; }
		.container { text-align: center; max-width: 480px; padding: 2rem; }
		h1 { font-size: 1.5rem; margin-bottom: 0.5rem; }
		p { color: ##666; line-height: 1.6; }
	</style>
</head>
<body>
	<div class="container">
		<h1>Something went wrong</h1>
		<p>We encountered an unexpected error processing your request. The issue has been logged and our team will look into it.</p>
		<p><a href="/">Return to homepage</a></p>
	</div>
</body>
</html>

bpamiri · 2026-06-11T18:47:02Z

bpamiri
Jun 11, 2026
Maintainer

👀

0 replies

bpamiri · 2026-06-12T00:29:20Z

bpamiri
Jun 12, 2026
Maintainer

@mikegrogan — you're not missing anything. We verified all three of your symptoms against the code and reproduced them live (Lucee 7 as a control, Adobe 2023 for your engine class). Every one of them is a real bug, and your report was precise enough that each is now root-caused, tracked, and fixed (PRs #3036, #3037, #3038 — all CI-green). The breakdown:

1. `?reload=testing&password=...` doing nothing → #3030, fixed in #3036

The app's public/Application.cfc is the only thing that restarts a stock app: its reload gate calls applicationStop() and then redirects through $buildRedirectUrl() — which deliberately strips reload, password, and lock from the query string (anti-loop logic). But the framework's environment switch in onapplicationstart.cfc needs URL.reload to be present on the request that starts the new application — which is the post-strip redirect. So the parameter is always gone, the restarted app re-reads config/environment.cfm, and nothing changes. The switch code is unreachable through the stock flow; the two halves were written against incompatible assumptions. Reproduced: the reload responds 302 Found, location: / and the environment stays development.

2. `Variable CFABORT is undefined` → #3029, fixed in #3037

Dispatch.cfc's "public component disabled → 404, don't fingerprint" block ends with bare cfabort; — Lucee-only tag-in-script syntax. Adobe parses it as a reference to an undefined variable and throws at runtime. You hit it just by loading / because the stock homepage is served by the public component, which is disabled in testing. We reproduced it on Adobe 2023, so it's every Adobe engine, not an ACF 2025 quirk. (Lucee control: clean 404 Not Found.) It escaped CI because the covering spec validates that branch by source inspection only — it never executes it. The fix is literally one token (abort;) plus a structural guard so the pattern can't come back.

3. Production "Not Found" + "Something went wrong" → same bug as 2

In production the block emits Not Found, then the cfabort crash bubbles into the friendly error template — the composite page you pasted, byte-for-byte in structure. One fix covers both.

Bonus finding while verifying: #3031, fixed in #3038

The "explicitly set allowEnvironmentSwitchViaUrl=true to allow switching in production-like environments" override is currently impossible to express — the code detects "explicit" by comparing against the default, and the default is true, so your set(allowEnvironmentSwitchViaUrl=true) is indistinguishable from not setting it. Even with #3030 fixed, you could switch into testing and never URL-switch back out. Also being fixed.

Until the fixes ship

Your working flow (edit environment.cfm + ?reload=true&password=...) remains the reliable path.
The Adobe crash can be hand-patched locally in one token if it's blocking you: vendor/wheels/Dispatch.cfc, in the enablePublicComponent 404 block, change cfabort; to abort;. (Yes — that means a vendor edit until the release, which is exactly the thing we don't want you to have to do; it'll be in the next patch release.)

Thanks for the high-signal report — stock install, exact URLs, the line link, and the raw production output made this a same-day diagnosis.

0 replies

mikegrogan · 2026-06-12T13:29:33Z

mikegrogan
Jun 12, 2026
Author

Good stuff. Thanks for reviewing!

0 replies

Navigation Menu

Uh oh!

Uh oh!

Issues with Environment Switching via url (wheels 4) #3023

Uh oh!

{{title}}

Uh oh!

Replies: 3 comments

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Uh oh!

Uh oh!

Issues with Environment Switching via url (wheels 4) #3023

Uh oh!

mikegrogan Jun 11, 2026

/config/environment.cfm

/config/settings.cfm

Replies: 3 comments

Uh oh!

bpamiri Jun 11, 2026 Maintainer

Uh oh!

bpamiri Jun 12, 2026 Maintainer

1. ?reload=testing&password=... doing nothing → #3030, fixed in #3036

2. Variable CFABORT is undefined → #3029, fixed in #3037

3. Production "Not Found" + "Something went wrong" → same bug as 2

Bonus finding while verifying: #3031, fixed in #3038

Until the fixes ship

Uh oh!

mikegrogan Jun 12, 2026 Author

mikegrogan
Jun 11, 2026

bpamiri
Jun 11, 2026
Maintainer

bpamiri
Jun 12, 2026
Maintainer

1. `?reload=testing&password=...` doing nothing → #3030, fixed in #3036

2. `Variable CFABORT is undefined` → #3029, fixed in #3037

mikegrogan
Jun 12, 2026
Author