Cursorでバグを修正する - エラーから原因特定・修正まで

1
2
3
4
5
6

指示例：
以下のエラーが発生しています。原因と修正方法を教えてください。

TypeError: Cannot read properties of undefined (reading 'map')
    at UserList (src/components/UserList.tsx:15:23)
    at renderWithHooks (node_modules/react-dom/cjs/react-dom.development.js:14985:18)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

Agentの分析結果例：

## エラー分析

### 原因
`UserList`コンポーネントの15行目で、`undefined`の値に対して
`.map()`メソッドを呼び出しています。これは、データがまだ
ロードされていない状態でレンダリングが行われた際に発生します。

### 該当コード
@src/components/UserList.tsx の15行目を確認すると：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// 問題のあるコード
const UserList = ({ users }) => {
  return (
    <ul>
      {users.map(user => (  // users が undefined の場合にエラー
        <li key={user.id}>{user.name}</li>
      ))}
    </ul>
  );
};

1
2
3
4
5
6

### 修正提案
以下のいずれかの方法で修正できます：

1. オプショナルチェーン（推奨）
2. デフォルト値の設定
3. 条件付きレンダリング

1
2
3
4
5
6

指示例：
以下のエラーが発生しています。
@src/components/UserList.tsx と @src/hooks/useUsers.ts を確認して、
原因と修正方法を提案してください。

TypeError: Cannot read properties of undefined (reading 'map')

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

指示例：
以下のスタックトレースを解析して、
根本原因と問題が発生している箇所を特定してください。

Error: ENOENT: no such file or directory, open '/app/config/production.json'
    at Object.openSync (node:fs:603:3)
    at Object.readFileSync (node:fs:471:35)
    at loadConfig (src/config/loader.ts:23:18)
    at initializeApp (src/app.ts:45:12)
    at Object.<anonymous> (src/index.ts:8:1)

1
2
3
4
5
6
7
8

指示例：
以下のエラーログには複数のエラーが含まれています。
根本原因となっている最初のエラーを特定し、
その修正によって解消される連鎖エラーも説明してください。

[Error] Database connection failed
[Error] UserService initialization failed  
[Error] Application startup failed

1
2
3

Agentの修正提案：

3つの修正方法を提案します。

1
2
3
4
5
6
7
8
9

const UserList = ({ users }) => {
  return (
    <ul>
      {(users ?? []).map(user => (
        <li key={user.id}>{user.name}</li>
      ))}
    </ul>
  );
};

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

const UserList = ({ users }) => {
  if (!users || users.length === 0) {
    return <p>ユーザーがいません</p>;
  }

  return (
    <ul>
      {users.map(user => (
        <li key={user.id}>{user.name}</li>
      ))}
    </ul>
  );
};

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

const UserList = ({ users, isLoading }) => {
  if (isLoading) {
    return <p>読み込み中...</p>;
  }

  if (!users || users.length === 0) {
    return <p>ユーザーがいません</p>;
  }

  return (
    <ul>
      {users.map(user => (
        <li key={user.id}>{user.name}</li>
      ))}
    </ul>
  );
};

1
2
3

指示例：
方法3のローディング状態を考慮した修正を適用してください。
useUsersフックにisLoading状態も追加してください。

1
2
3
4

指示例：
修正を適用しました。
ターミナルで開発サーバーを再起動し、
エラーが解消されたか確認してください。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

指示例：
以下のバグ報告を分析し、原因を特定してください。

【バグ報告】
タイトル: ユーザー検索で日本語が正しく検索できない
再現手順:
1. 検索ボックスに「田中」と入力
2. 検索ボタンをクリック
3. 結果が0件と表示される

期待される動作: 「田中」を含むユーザーが表示される
実際の動作: 結果が0件

環境: Chrome 120, Windows 11

1
2
3
4

指示例：
デバッグモードで @src/services/search.service.ts の
search メソッドを調査してください。
「田中」で検索した際の変数の状態を確認したいです。

1
2
3
4
5
6
7

指示例：
原因特定のために、以下の関数にデバッグログを追加してください。
- 入力値
- 各処理ステップの結果
- 最終的な戻り値

@src/services/search.service.ts の search メソッド

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

async search(query: string): Promise<User[]> {
  console.log('[search] Input query:', query);
  console.log('[search] Query length:', query.length);
  console.log('[search] Query encoded:', encodeURIComponent(query));
  
  const normalizedQuery = this.normalizeQuery(query);
  console.log('[search] Normalized query:', normalizedQuery);
  
  const results = await this.userRepository.search(normalizedQuery);
  console.log('[search] Results count:', results.length);
  console.log('[search] Results:', JSON.stringify(results, null, 2));
  
  return results;
}

1
2
3
4
5
6
7
8
9

指示例：
ログを追加して実行したところ、以下の出力が得られました。
この結果から原因を特定し、修正してください。

[search] Input query: 田中
[search] Query length: 2
[search] Query encoded: %E7%94%B0%E4%B8%AD
[search] Normalized query: 
[search] Results count: 0

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

Agentの分析結果：

## 原因特定

normalizeQuery の結果が空文字列になっています。
これが原因で検索結果が0件になっています。

normalizeQuery メソッドを確認したところ、
ASCII文字以外を除去する処理が含まれていました。

### 問題のあるコード

1
2
3

normalizeQuery(query: string): string {
  return query.replace(/[^\x00-\x7F]/g, ''); // ASCII以外を除去
}

1
2
3

### 修正案

日本語を含むUnicode文字を保持するように修正：

1
2
3
4
5
6

normalizeQuery(query: string): string {
  return query
    .trim()
    .toLowerCase()
    .replace(/\s+/g, ' '); // 空白の正規化のみ
}

1
2
3
4
5
6

指示例：
以下のバグは10回に1回程度しか発生しません。
考えられる原因と調査方法を提案してください。

症状: 注文処理が稀に失敗する
エラー: "Deadlock detected"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

Agentの分析：

## デッドロックの原因候補

1. **並行トランザクションの競合**
   - 複数の注文が同時に処理される際にロック競合

2. **トランザクションの順序不整合**
   - 異なる処理が異なる順序でテーブルをロック

3. **長時間トランザクション**
   - タイムアウト前にロック解放が行われない

## 調査方法

1. ログにトランザクションIDと実行時間を追加
2. データベースのデッドロックログを確認
3. 負荷テストで再現を試みる

1
2
3
4
5

指示例：
アプリケーションを長時間稼働させるとメモリ使用量が
増加し続けます。メモリリークの原因を調査してください。

@src/services/event.service.ts

1
2
3
4
5

指示例：
以下のコードで「Promise resolution is still pending」という
警告が出ています。原因と修正方法を教えてください。

@src/controllers/upload.controller.ts

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

追加情報を含めた指示例：
先ほどの分析は的外れでした。以下の追加情報を考慮してください：

- このプロジェクトはNest.js を使用しています
- データベースはPostgreSQLです
- 認証にはJWTを使用しています

@src/auth/auth.module.ts
@src/config/database.config.ts

この情報を踏まえて再分析してください。

1
2
3
4
5
6
7
8

指示例：
前回の修正を適用したところ、別のエラーが発生しました。

新しいエラー:
"Cannot find module './utils' from 'src/services/user.service.ts'"

元の修正と今回のエラーの関係を分析し、
両方を解決する修正を提案してください。

1
2
3
4
5
6
7
8
9

指示例：
このバグはローカル環境では再現できず、
本番環境でのみ発生します。

環境の違い：
- ローカル: Node.js 20, SQLite
- 本番: Node.js 18, PostgreSQL

環境差異が原因となる可能性を分析してください。