Panic (Crash): json: unsupported value: NaN when API returns invalid solar forecast data

[MatzeBu]

Describe the bug

evcc crashes entirely (throws a panic) when an external solar forecast service (in this case api.akkudoktor.net) seemingly returns an invalid value.
Instead of gracefully ignoring the bad data or issuing a warning, evcc produces a NaN value internally, which then causes a fatal crash when socketEncode tries to marshal the data into JSON for the Web UI or MQTT.
This results in a continuous boot-loop.

Starting evcc without an internet connection (so the API request fails cleanly with connection refused instead of receiving a bad payload) allows evcc to start and run normally.

Steps to reproduce

Configure api.akkudoktor.net as a solar forecast template in evcc.yaml (see config below).

Start evcc.

If the Akkudoktor API currently returns empty/invalid data, evcc will crash immediately after the solar forecast: accumulated... debug log.

Expected behavior:
evcc should catch invalid data (like empty strings or formatting errors from external APIs) and handle them gracefully (e.g., fallback to 0 or simply ignore the forecast for that cycle) instead of crashing with a panic.

Log (evcc 0.303.2):

Configuration details

solar:
  type: template
  template: api.akkudoktor.net
  lat: 50.67
  lon: 12.68
  dec: 5 
  kwp: 9.2 
  az: -101
  horizon: "5,5,5,5,10,10,22,22,32,32,10,15,15,18,22t0.3,25t0.3,25t0.3,25t0.4,20t0.4,20t0.4,32t0.2,35t0.1,30t0.1,28t0.1,25t0.1,20t0.1,20,20,20,20,10,10,5,5,5,5"

Log details

[site  ] DEBUG 2026/03/23 11:58:53 solar forecast: accumulated 4.543Wh from 0001-01-01 00:00:00 +0000 UTC to 2026-03-23 11:58:53 +0100 CET
[site  ] DEBUG 2026/03/23 11:58:53 solar forecast: produced 570.000
[site  ] DEBUG 2026/03/23 11:58:53 solar forecast: accumulated 566.195kWh, produced 570.000kWh, scale 1.007
[lp-1  ] DEBUG 2026/03/23 11:58:53 set smart cost limit: 0.1
[lp-1  ] DEBUG 2026/03/23 11:58:53 set battery boost limit: 15
[lp-1  ] DEBUG 2026/03/23 11:58:53 phase timer inactive
[lp-1  ] DEBUG 2026/03/23 11:58:53 pv timer inactive
[lp-1  ] DEBUG 2026/03/23 11:58:53 set charge current limit: 6A
[lp-2  ] DEBUG 2026/03/23 11:58:53 set smart cost limit: 0.1
[lp-2  ] DEBUG 2026/03/23 11:58:53 set battery boost limit: 75
[mqtt  ] ERROR 2026/03/23 11:58:53 marshal bytes: json: unsupported value: NaN
[lp-2  ] DEBUG 2026/03/23 11:58:53 phase timer inactive
[lp-2  ] DEBUG 2026/03/23 11:58:53 pv timer inactive
[lp-2  ] INFO 2026/03/23 11:58:53 vehicle updated: unknown -> Cupra Born
panic: json: unsupported value: NaN

goroutine 86 [running]:
github.com/evcc-io/evcc/server.socketEncode({0x1f5c940?, 0x7f77766b40?})
	github.com/evcc-io/evcc/server/socket_helper.go:47 +0xbc
github.com/evcc-io/evcc/server.(*SocketHub).broadcast-range1({0x1ecd007, 0x5}, {0x1f5c940?, 0x7f77766b40?})
	github.com/evcc-io/evcc/server/socket.go:167 +0x64

What type of operating system or environment does evcc run on?

HomeAssistant Add-on

External automation

• I have made sure that no external automation like HomeAssistant or Node-RED is active or accessing any of the mentioned devices when this issue occurs.

Nightly build

• I have verified that the issue is reproducible with the latest nightly build

Version

0.303.2

[An-Wi]

Not sure if the API call to akkudoktor is causing the crash!?

Your log shows more entries after accumulation solar forecast.

[TTXaser2]

Ich hab denselben Fehler mit dem unsupported value. Nachdem ich das hier gelesen habe, hab ich den Forecast vom Akkudoctor rausgenommen, jetzt läuft EVCC wieder!

[An-Wi]

ok, danke für die Info.
Mich wundert nur, dass die Werte von akkudoctor in meinem Log plausibel aussehen...

2. Problem: Hab die Konfiguration der Tarife in die UI verschoben. Somit komme ich momentan nicht mehr ran, weil evcc abstürzt, sobald ich ein Web-Interface öffne!

[TTXaser2]

Ich hab 3 PV-Anlagen in unterschiedlicher Ausrichtung auf dem Grundstück, für zwei von den Anlagen benutze ich den Solarforecast von SolCast, für die dritte Anlage den vom Akkudoktor (Solcast kann gratis max. 2 Anlagen). Ich hab in meiner YAML ausschliesslich den Forecast vom Akkudoktor auskommentiert, seitdem läuft wie oben bereits gesagt, EVCC wieder stabil.

Ich hab mal im Log geschaut für heute mittag als EVCC sich ständig selbst neu gestartet hat. Hier mal ein Auszug von Service-Start bis Service-Neustart, vielleicht hilft's ja. Bezeichnen eben auch der von @MatzeBu beschriebene JSON-Panic bei 13:02:04, ohne seinen Hinweis hätte ich das aber nicht auf den Akkudoktor-Forecast bezogen.
Sorry für die Darstellung, ich bin zu blöd das Log als Log zu formatieren

Mar 23 13:01:53 raspberrypi systemd[1]: Started evcc. Mar 23 13:01:54 raspberrypi evcc[802]: [main ] INFO 2026/03/23 13:01:54 evcc 0.303.2 Mar 23 13:01:54 raspberrypi evcc[802]: [main ] INFO 2026/03/23 13:01:54 using config file: /etc/evcc.yaml Mar 23 13:01:54 raspberrypi evcc[802]: [main ] INFO 2026/03/23 13:01:54 using sqlite database: /var/lib/evcc/evcc.db?_pragma=busy_timeout(5000) Mar 23 13:01:54 raspberrypi evcc[802]: [eebus ] INFO 2026/03/23 13:01:54 Local SKI: a4a072157f971c84d36bd53bce4615dea526d2d6 Mar 23 13:01:55 raspberrypi evcc[802]: [main ] INFO 2026/03/23 13:01:55 OCPP local url: ws://127.0.0.1:8887/<stationId> Mar 23 13:01:55 raspberrypi evcc[802]: [main ] INFO 2026/03/23 13:01:55 UI local url: http://127.0.0.1:7070 Mar 23 13:02:04 raspberrypi evcc[802]: panic: json: unsupported value: NaN Mar 23 13:02:04 raspberrypi evcc[802]: goroutine 97 [running]: Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server.socketEncode({0x1f5c840?, 0x7f5b23e500?}) Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server/socket_helper.go:47 +0xbc Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server.(*SocketHub).broadcast-range1({0x1eccffa, 0x5}, {0x1f5c840?, 0x7f5b23e500?}) Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server/socket.go:167 +0x64 Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/util.(*sharderImpl).shards.func1(0x7f5b69c180) Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/util/param_shard.go:61 +0xf8 Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server.(*SocketHub).broadcast(0x7f54123170, {0x0, {0x2788fde, 0x8}, {0x2356860, 0x7f5b598260}}) Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server/socket.go:166 +0x264 Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server.(*SocketHub).Run(0x7f54123170, 0x7f5aee1730, 0x7f5b9004c0) Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/server/socket.go:194 +0xa8 Mar 23 13:02:04 raspberrypi evcc[802]: created by github.com/evcc-io/evcc/cmd.runRoot in goroutine 1 Mar 23 13:02:04 raspberrypi evcc[802]: github.com/evcc-io/evcc/cmd/root.go:243 +0x9f8 Mar 23 13:02:04 raspberrypi systemd[1]: evcc.service: Main process exited, code=exited, status=2/INVALIDARGUMENT Mar 23 13:02:04 raspberrypi systemd[1]: evcc.service: Failed with result 'exit-code'. Mar 23 13:02:04 raspberrypi systemd[1]: evcc.service: Consumed 3.818s CPU time. -- Boot a3cb5e55abfd4d68ab49cb7d92af6441 -- Mar 23 13:02:09 raspberrypi systemd[1]: Started evcc.

[andig]

Akkudoktor is deprecated, and is so for a reason- it is unreliable. That said, evcc shouldn't panic.

@naltatis wondering if we can highlight deprecated configuration in the UI as working and attach that to bug reports?

Closed in 2d3e7ed

[An-Wi]

Was ich nicht verstehe, wieso ist evcc plötzlich nicht mehr in der Lage die API von Akkudoktor zu lesen, wenn die Werte im Log plausibel aussehen?
Auch ein direkter API-Call im Browser liefert für mein Verständnis sinnvolle Werte.
In der Struktur der gelieferten Daten sehe ich auch keine wirkliche Veränderung zu vorher?

Noch viel merkwürdiger finde ich, dass evcc (laut Logs) problemlos im Hintergrund arbeitet, sogar die solar forecast weiter kalkuliert und erst in dem Moment crashed, wenn man das UI aufruft?

Auch die Frage von @Danielmohr81 (keine Ahnung, warum die hier im Verlauf verschwunden ist - habe eine Benachrichtigung dazu bekommen - sehe sie aber nicht mehr) ist durchaus berechtigt:
"Wie kann ich denn einen Eintrag den ich in der WEB UI gemacht habe händisch rausnehmen, wenn ich nicht in das System komme? In der YAML steht es natürlich nicht mehr drin."
Da ihr die Transformation von YAML zur UI forciert, darf sowas eigentlich nicht passieren, oder?