Automatic Persisted Queries work with hybrid cache mode

[Kauto]

I had a problem with production servers when enabling hybrid mode. The webpage uses APQ and when locking up the query in the cache, the content is a "string" instead of a "DocumentNode":

[2025-11-28 14:32:34] production.ERROR: Nuwave\Lighthouse\GraphQL::loadPersistedQuery(): Return value must be of type GraphQL\Language\AST\DocumentNode, string returned {"userId":18,"exception":"[object] (TypeError(code: 0): Nuwave\\Lighthouse\\GraphQL::loadPersistedQuery(): Return value must be of type GraphQL\\Language\\AST\\DocumentNode, string returned at /var/www/app/vendor/nuwave/lighthouse/src/GraphQL.php:330)
[stacktrace]
#0 /var/www/app/vendor/nuwave/lighthouse/src/GraphQL.php(263): Nuwave\\Lighthouse\\GraphQL->loadPersistedQuery()
#1 /var/www/app/vendor/nuwave/lighthouse/src/GraphQL.php(216): Nuwave\\Lighthouse\\GraphQL->executeOperation()
#2 /var/www/app/vendor/nuwave/lighthouse/src/Support/Utils.php(108): Nuwave\\Lighthouse\\GraphQL->{closure:Nuwave\\Lighthouse\\GraphQL::executeOperationOrOperations():216}()
#3 /var/www/app/vendor/nuwave/lighthouse/src/GraphQL.php(214): Nuwave\\Lighthouse\\Support\\Utils::mapEach()
#4 /var/www/app/vendor/nuwave/lighthouse/src/Http/GraphQLController.php(32): Nuwave\\Lighthouse\\GraphQL->executeOperationOrOperations()
#5 /var/www/app/vendor/laravel/framework/src/Illuminate/Routing/ControllerDispatcher.php(46): Nuwave\\Lighthouse\\Http\\GraphQLController->__invoke()
[...]
"}

• Added or updated tests
• Documented user facing changes
• Updated CHANGELOG.md

Changes

I updated the function to use the new queryCache and thus always use the correct method to load the DocumentNode. I added a test to detect this error in the future.

[spawnia]

@Kauto Looks pretty good. Please check the failing test cases - probably just need to change the fn(): never to function (): void {.

[spawnia]

Thanks, nicely done

[spawnia]

Released with https://github.com/nuwave/lighthouse/releases/tag/v6.63.2