GraphQLでサブスクリプションを使用しようとしたときに「Schema is not configured for subscriptions」というエラーが表示されることがあります。このエラーは、GraphQLスキーマがサブスクリプションに対応するように正しく設定されていないことを示しています。以下では、このエラーの原因と解決方法について詳しく説明します。

エラーの原因

このエラーが発生する主な理由は以下の通りです：

1. サブスクリプション用のスキーマが定義されていない

2. サーバー側でサブスクリプションのサポートが有効になっていない

3. クライアント側の設定が不適切

解決方法

1. スキーマにサブスクリプションを追加する

GraphQLスキーマにサブスクリプションタイプを追加することが重要です。以下は基本的な例です：

type Subscription {
  newMessage: Message
}

2. サーバー側の設定を確認

サーバー側でサブスクリプションをサポートするように設定されていることを確認します。使用しているGraphQLサーバーやライブラリによって設定方法が異なります。

例えば、Apollo Serverを使用している場合は以下のように設定します：

const { ApolloServer } = require('apollo-server');
const { PubSub } = require('graphql-subscriptions');

const pubsub = new PubSub();

const server = new ApolloServer({
  typeDefs,
  resolvers,
  context: { pubsub }
});

3. リゾルバーの実装

サブスクリプションのリゾルバーを正しく実装することも重要です：

const resolvers = {
  Subscription: {
    newMessage: {
      subscribe: () => pubsub.asyncIterator(['NEW_MESSAGE'])
    }
  }
};

4. クライアント側の設定

クライアント側でもサブスクリプションをサポートするための設定が必要です。Apollo Clientを使用している場合は、WebSocketリンクを設定します：

import { ApolloClient, InMemoryCache, HttpLink, split } from '@apollo/client';
import { WebSocketLink } from '@apollo/client/link/ws';
import { getMainDefinition } from '@apollo/client/utilities';

const httpLink = new HttpLink({
  uri: 'http://localhost:4000/graphql'
});

const wsLink = new WebSocketLink({
  uri: 'ws://localhost:4000/graphql',
  options: {
    reconnect: true
  }
});

const splitLink = split(
  ({ query }) => {
    const definition = getMainDefinition(query);
    return (
      definition.kind === 'OperationDefinition' &&
      definition.operation === 'subscription'
    );
  },
  wsLink,
  httpLink
);

const client = new ApolloClient({
  link: splitLink,
  cache: new InMemoryCache()
});

まとめ

「Schema is not configured for subscriptions」エラーを解決するには、スキーマの定義、サーバー側の設定、リゾルバーの実装、そしてクライアント側の設定を正しく行う必要があります。これらのステップを順番に確認し、必要に応じて修正することで、GraphQLサブスクリプションを正常に機能させることができます。

エラーが解決しない場合は、使用しているGraphQLライブラリやフレームワークの公式ドキュメントを参照するか、開発者コミュニティに相談することをおすすめします。GraphQLの実装方法は環境によって異なる場合があるため、具体的な状況に応じたアドバイスを得ることが重要です。