troubleshoot

Diagnose and resolve runtime errors across MySQL, Ollama, FastAPI, and Spring Boot services.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/VelkaressiaBlutkrone/spring-python-llm-exam-mng --skill troubleshoot-velkaressiablutkrone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/VelkaressiaBlutkrone/spring-python-llm-exam-mng/tree/main/.claude/skills/troubleshoot
Command: npx skills add https://github.com/VelkaressiaBlutkrone/spring-python-llm-exam-mng --skill troubleshoot-velkaressiablutkrone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running a multi-service LLM medical consultation system, failures can occur at any layer—Docker MySQL, Ollama, the Python FastAPI server, or Spring Boot—and it is hard to know where to start. This Skill classifies error messages, checks infrastructure health, and applies known fixes for each failure category. ## Core Features & Use Cases - Error Classification: Maps error keywords (e.g., Connection refused :3307, Connection refused :11434) to the failing component such as MySQL, Ollama, the Python LLM server, or Spring Boot. - Infrastructure Health Checks: Provides concrete commands like docker-compose ps, curl http://localhost:11434/api/tags, and curl http://localhost:8000/health to verify each service. - Category-Specific Fixes: Covers common issues including MySQL connection failures, missing Ollama models, Python dependency problems, Spring Boot to Python connectivity (503 errors), garbled Korean/Chinese LLM output, and JPA schema mismatches. - Use Case: You start the project and get "LLM 서버를 사용할 수 없습니다" (503). The Skill walks you through testing the Python endpoint directly, checking the startup order (MySQL → Ollama → Python → Spring Boot), and verifying llm.service.url in application.yml. ## Quick Start Type /troubleshoot or paste your error message and ask the assistant to diagnose why the server is not starting.

Frequently Asked Questions about troubleshoot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix MySQL connection refused errors in Docker?▼

MySQL connection refused errors usually mean the Docker container is not running. Run docker-compose ps to check status, start it with docker-compose up -d, and verify port 3307 is not in conflict. Also confirm MYSQL_USER and MYSQL_PASSWORD in your .env file.

How do I troubleshoot Ollama connection refused on port 11434?▼

Ollama connection refused means the Ollama server is not running. Start it with ollama serve, verify installed models with ollama list, and pull the required model with ollama pull qwen2.5:7b if it is missing.

Why does Spring Boot return 503 saying the LLM server is unavailable?▼

A 503 from Spring Boot means it cannot reach the Python FastAPI server. Check the startup order (MySQL, then Ollama, then Python, then Spring Boot), test the endpoint directly with curl on port 8000, and verify llm.service.url in application.yml.

Why is my LLM responding with Chinese characters or broken text?▼

Garbled LLM output usually comes from a missing system prompt or inactive response filtering. Check the system prompt in app.py, verify the clean_llm_response function in response_cleaner.py runs, and use a Korean-capable model such as qwen2.5:7b.

What is the correct startup order for a Spring Boot, FastAPI, Ollama, and MySQL stack?▼

Start services in this order: Docker MySQL first, then the Ollama server, then the Python FastAPI server with uvicorn on port 8000, and finally Spring Boot. Verify each layer with health checks before starting the next one.