I just want quickly to share my experience of this problem - YMMV.
For me, I was also indifferent to this "unreliable interface" right up to the point where the Mac would fail tasks due to lack of disk space, even when I "knew" there was plenty. Then I got interested! ;-)
Long story short, Apple support (Europe) won't help you, because their "script" goes from Step 1 - "restart everything", Step 2, "Oh, you're right - soemthing is wrong", Step 3 "Reinstall the OS". This was where I ended up after a 2-hour phone call with 3 different advisors, escallating to a so-called "senior advisor" in Ireland. I declined to pick up that proffered sledghammer. You may have more luck with US advisors, who, anecdotally, seem to have more both expertise and patience.
For me, the problem turned out to be with Time Machine. Firstly to understand the "unreliable interface" a little:
The terminal commands @leroydouglas has given you above tells you what's REALLY going on with your disk space, as understood by the underlying UNIX operating system. The "Storage" user interface does not count storage that it thinks is temporary and will be reused/overwritten/purged my MacOS and associated applications, reasoning that MacOS/apps will be able to use that already-used space if needs be.
However, it is possible for some apps (in my case Time Machine) to loose track of this temporary (and therefore not counted) storage, and never tidy it up. Time Machine keeps local snapshots (on your source disk) of backup data, before incorporating those snapshots into the backup on the target (usually external) disk. These can be several and very large (in my case ~280 GB).
The solution to my problm was shockingly simple and easy - delete these "orphaned" local snapshots. Shockingly - because 2 hours of Apple support didn't even mention anything like this. Simple - because you only have type a couple of commands.
Turn off your Time Machine and let any backup in progress complete. Then you can view your local snapshots like so:
$ tmutil listlocalsnapshots /
This will give you a list of any that exist; note their timestamps, then get rid of them
$ sudo tmutil deletelocalsnapshots <timestamp>
Once done, I recommend waiting a while, checking the "real" disk space with the command
$ df -h /
and after the space has been "recovered", do a reboot.
Here is a better description of tmutil for this use case:- https://apple.stackexchange.com/questions/362552/something-taking-up-90gb-of-storage-in-macos-catalina-10-15-beta
Hope this helps