Common Errors

Error: 401 Unauthorized - authentication required

# Check token is set
echo $GF_PUB_TOKEN

# Verify token format (should start with gf_live_ or gf_test_)
echo $GF_PUB_TOKEN | cut -d'_' -f1-2

# Test token
curl -H "Authorization: Bearer $GF_PUB_TOKEN" \
  https://registry.yourcompany.com/v1/me

Error: Package 'my_package' not found

# Check package exists
curl https://registry.yourcompany.com/v1/packages/my_package \
  -H "Authorization: Bearer $TOKEN"

# Verify pubspec.yaml
dependencies:
  my_package:
    hosted:
      name: my_package  # Check spelling
      url: https://registry.yourcompany.com
    version: ^1.0.0

Error: Version 1.0.0 of my_package already exists

version: 1.0.1  # or 1.1.0, or 2.0.0

Because package_a depends on http ^0.13.0 and package_b depends on http ^1.0.0,
package_a is incompatible with package_b.

# See dependency tree
flutter pub deps

# Try latest versions
flutter pub upgrade --major-versions

# Use dependency override (temporary)
dependency_overrides:
  http: ^1.0.0

Error: 403 Forbidden - insufficient permissions

# Check permissions
curl https://registry.yourcompany.com/v1/me/permissions \
  -H "Authorization: Bearer $TOKEN"

# Check workspace membership
curl https://registry.yourcompany.com/v1/workspaces/ws_ID/members/me \
  -H "Authorization: Bearer $TOKEN"

Error: 402 Payment Required - package limit reached

curl -X POST https://registry.yourcompany.com/v1/workspaces/ws_ID/subscription \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"plan": "pro"}'

Error: Connection refused to https://registry.yourcompany.com

# Check registry health
curl https://registry.yourcompany.com/health

# Check DNS
nslookup registry.yourcompany.com

# Check connectivity
ping registry.yourcompany.com

Error: SSL certificate verify failed

# Check certificate
openssl s_client -connect registry.yourcompany.com:443

# Update CA certificates
# macOS
brew install ca-certificates

# Ubuntu
sudo apt-get install ca-certificates

Error: Could not find pub-tokens.json

mkdir -p ~/.pub-cache
cat > ~/.pub-cache/pub-tokens.json << EOF
{
  "version": 1,
  "hosted": [
    {
      "url": "https://registry.yourcompany.com",
      "token": "\${GF_PUB_TOKEN}",
      "env": "GF_PUB_TOKEN"
    }
  ]
}
EOF

Error: pubspec.yaml is invalid

# ✗ Bad - no version
name: my_package
description: My package

# ✓ Good - complete
name: my_package
version: 1.0.0
description: My package with description over 60 characters long

environment:
  sdk: '>=3.0.0 <4.0.0'