Skip to main content
This troubleshooting guide helps you diagnose and resolve common issues in GitOps workflows with Bytebase.

​
Common Issue Categories

Release and Plan Issues

Invalid files, SHA256 mismatches, release not found, plan creation failures

Rollout Issues

Skipped tasks, pending approvals, SQL errors, permissions, connectivity

SDL Issues

Schema qualification, constraints, foreign keys, validation errors

CI/CD Issues

GitHub Actions, authentication, SQL review failures in CI

​
Quick Diagnostics

​
Check System Status

# Verify Bytebase is accessible
curl -f $BB_URL/v1/actuator/info

# Test authentication
curl -H "Authorization: Bearer $BB_TOKEN" \
  $BB_URL/v1/actuator/info

​
View Recent Releases

# List releases in project
curl -X GET "$BB_URL/v1/projects/my-project/releases" \
  -H "Authorization: Bearer $BB_TOKEN"

​
Check Task Logs

  1. Navigate to the rollout in Bytebase UI
  2. Click on the failed task
  3. View execution logs for error details

​
Getting Help

If you’ve tried these solutions and still need help:
  1. Check documentation:
  2. Review logs:
    • Task execution logs in Bytebase UI
    • CI/CD workflow logs
    • Database server logs
  3. Community support:
  4. Enterprise support:
    • Contact your Bytebase account team
    • Submit support ticket via dashboard
    • Schedule technical consultation

GitOps Overview

Understand the complete GitOps workflow

Best Practices

Production-ready patterns

API Reference

Complete API documentation

Error Codes

SQL review error reference