Troubleshooting Spring Boot GraphQLQueryResolver not running on main project but running on test project

Published on 2023.11.16


In Spring Boot applications, GraphQL is becoming increasingly popular for implementing APIs. It provides a powerful and flexible way to query and manipulate data. However, sometimes developers may encounter an issue where the GraphQLQueryResolver is not being picked up and run on the main project but is running fine on the test project.

In this article, we will explore the possible reasons behind this issue and provide actionable solutions to fix it.

Possible Causes

  1. Incorrect Package Scanning: One common cause for this issue is incorrect package scanning configuration. By default, Spring Boot scans all the packages under the main application class's package, but it may not scan packages located outside the main project.

  2. Incorrect Bean Configuration: Another possible cause is incorrect bean configuration. If the GraphQLQueryResolver is not properly configured as a bean, it will not be picked up by the Spring container.

  3. Test Configuration Overrides: If the test project has different configurations than the main project, it can create conflicts and prevent the GraphQLQueryResolver from being picked up correctly on the main project.


  1. Package Scanning Configuration: Make sure that the package containing the GraphQLQueryResolver is included in the component scan configuration. You can do this by adding the @ComponentScan annotation with the correct package(s) to your main application class.

    @ComponentScan(basePackages = {"com.example.project", "com.example.graphql"})
    public class MainApplication {
       // main application code
  2. Bean Configuration: Ensure that the GraphQLQueryResolver is properly configured as a bean. You can achieve this by using the @Bean annotation on a method that returns an instance of the GraphQLQueryResolver.

    public class GraphQLConfig {
       public GraphQLQueryResolver graphQLQueryResolver() {
           return new MyGraphQLQueryResolver();
  3. Check Test Configuration: Review the test project's configuration and make sure that it does not override or conflict with the main project's configuration. Check for any specific test configuration files or properties that may impact the GraphQLQueryResolver's behavior.


When encountering the issue of the GraphQLQueryResolver not running on the main project but working fine on the test project, it is essential to check and verify the package scanning configuration, bean configuration, and potential conflicts caused by test project configurations. By following the suggested solutions, you should be able to resolve the issue and get the GraphQLQueryResolver running correctly on your main project.

Remember to always review and test your configuration changes thoroughly to ensure they do not introduce any new issues or conflicts.