Troubleshouting

Common errors

If any errors are detected during the build phase, the console and browser will display an error message. Common causes for errors are:

[next] [GraphQL Errors] failed to fetch to https://magento.test/graphql products

You are connecting with a local endpoint with a self signed SSL certicate, start your dev server with NODE_TLS_REJECT_UNAUTHORIZED=0 yarn dev

[next] 🕸️ - m2: Failed to generate schema: request to [...] failed, reason: connect ETIMEDOUT

Missing magentoEndpoint in your graphcommerce.config.js

🕸️ - m2: Failed to generate schema: invalid json response body at [...] reason: Unexpected '<'

magentoEndpoint environment variable is not pointing to a Magento graphql endpoint

[next] error - Error: Unexpected token < in JSON at position 0

The Magento version is outdated. Make sure you are running Magento 2.4.3 and up

Error: Invalid src prop ([...]) on 'next/image', hostname "[...]" is not configured under images in your 'next.config.js'

Add the image domain to the next.config.js

node_modules/@graphcommerce/graphql/generated/fragments.json
Error: Interface field RoutableInterface.type expects type UrlRewriteEntityTypeEnum but BundleProduct.type is type String.

In the Magento store, a product attribute is configured with attribute_code 'type'. Migrate the product information to a new attribute and remove the product attribute named 'type'.

Next steps

Learn how to Set up Visual Studio Code and install usefull extensions for an optimal development experience