Skip to main content
J
jarviswabi
Inspiring
January 13, 2026
Question

Error trying to use getGraphQLClient on CF2023 Enterprise

  • January 13, 2026
  • 1 reply
  • 114 views

I'm running CF2023 Enterprise on Windows and am trying to test out the getGraphQLClient for a Shopify API integration, but I keep getting this error trying to make the getGraphQLClient call:

Can't find resource for base name coldfusion/osgi/services/resource.properties

 My test code simply consists of this:

	<cfset shopifyConfig = {
	    "endpoint": "#apiurl#",
	    "headers": {
	        "X-Shopify-Access-Token": "#session.shopify_access_token#",
	        "Content-Type": "application/json"
	    }
	}>
	<cfset shopifyClient=getGraphQLClient(shopifyConfig)>

I've already implemented the direct cfhttp call to get my access token and have actually been successful in connecting to Shopify with manually constructed GraphQL queries through cfhttp.  I'd just like to see if the baked-in GraphQL client offers some efficiency.

 

I've looked at several posts about this error and clearing the felix-cache with a restart of CF, which I've tried several times on two different servers.  I also uninstalled and reinstalled the graphql package, both through the CF Admin and cfpm.bat.  No change in results.

 

I understand that being on Update 12 puts me a little behind in terms of updates, but trying to install the newer updates on one of my test servers led me into the Failed Signature mess, so before I try to tackle THAT and potentially mess up my entire environment, I wanted to see if there's anything other reason why the GraphQL client shouldn't be working in Update 12.  Thanks in advance!

    1 reply

    BKBK
    Community Expert
    BKBKCommunity Expert
    Community Expert
    January 13, 2026

    The arguments you're using for getGraphQLClient are different from what the documentation suggests.

    The documentation mentions the example,

    gqlClient = getGraphQLClient({
	    service_name: "server-name",
	    type: "graphqlclient",
	    raw_http_client: true,
	    service_url: "endpoint-url",
	    root_folder: "root_folder",
	    headers: { values: "auth-value", keys: "auth-key" },
	    batching_configuration: { enabled: true, batch_interval_ms: 10, max_batch_size: 15 },
	    subscription_configuration: { websocket_url: "wss://websocket-url", subscription_heartbeat_timeout: 5, subscription_heartbeat_timeunit: "nano" }
});

     References:

     

    J
    jarviswabiAuthor
    Inspiring
    January 14, 2026

    Thanks BKBK - I did notice that after posting, so I tried one of the generic test examples from the CF docs:

    <cfscript> 
    // get the graphQL service first 
     gqlClient = getGraphQLClient({ 
      service_Url : "https://apollo-fullstack-tutorial.herokuapp.com/graphql", 
      root_folder: "root", 
      headers : { 
          keys: "Authorization", 
          values: "value" 
        } 
    }); 
    generateGraphQLModels();   
    queryObj = gqlClient.query("MissionDetails", {});   
    response=queryObj.execute() 
    response.get("Data") 
</cfscript>

    That still produces the same "Can't find resource" error.  I also think that if the problem with my example were the parameters, the error message would be different.  This isn't complaining about HOW I'm calling it, it's saying it can't even load the Java resources for the GraphQL client.

     

    I'm finding the documentation on this feature to be very confusing, as it references several things that are not explained (what is service_name and root_folder), and contains no simple examples of how to connect to a GraphQL API  endpoint without setting other stuff up.  It references files in folder inside the cfusion directory but with no explanation of when and how you're supposed to do all that.  And quite honestly, if that error message I'm seeing is what is supposed to happen when you don't make that call properly, this whole thing is absolutely underbaked and should never have been released.  That's why I think I'm dealing with a more fundamental problem about actually getting the getGraphQLClient function to even execute.

     

    Does ANYBODY out there have a working real-life example of how to connect to ANY public GraphQL endpoint?  I'd love if it was Shopify, but I'd settle for anything.

    BKBK
    Community Expert
    BKBKCommunity Expert
    Community Expert
    January 14, 2026

    Hi @jarviswabi ,

    Thanks for the update. The error "Can't find resource for base name coldfusion/osgi/services/resource.properties" suggests an error in ColdFusion. You should report it as a bug.

    Terms & ConditionsAccessibility statement
    Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices