How to fix StorageApiError: Object not found in Supabase

// Example: Check your file path
const fileName = 'profile-pictures/user-123.jpg';
const bucketName = 'avatars';

// Common mistakes:
// 1. Missing file extension
const wrongPath = 'profile-pictures/user-123'; // Missing .jpg

// 2. Incorrect bucket
const wrongBucket = 'avatar'; // Should be 'avatars'

// 3. Extra slashes or incorrect path structure
const messyPath = '/avatars//profile-pictures/user-123.jpg'; // Extra slashes

// Correct usage:
const { data, error } = await supabase.storage
  .from(bucketName)
  .download(fileName);

// List all files in the bucket to see what's available
const { data: files, error } = await supabase.storage
  .from('your-bucket-name')
  .list('folder-path', {
    limit: 100,
    offset: 0,
    sortBy: { column: 'name', order: 'asc' }
  });

if (error) {
  console.error('Error listing files:', error);
} else {
  console.log('Files in bucket:', files);
  // Check if your file is in the list
  const fileExists = files.some(file => file.name === 'your-file.jpg');
  console.log('File exists:', fileExists);
}

// Example upload with proper error handling
const uploadFile = async (file) => {
  const { data, error } = await supabase.storage
    .from('bucket-name')
    .upload('folder/' + file.name, file, {
      cacheControl: '3600',
      upsert: false // Set to true if you want to overwrite existing files
    });

  if (error) {
    console.error('Upload failed:', error);
    // Handle specific error types
    if (error.message.includes('already exists')) {
      console.log('File already exists, consider using upsert: true');
    }
    return null;
  }

  console.log('Upload successful:', data.path);
  return data.path; // Save this path for future reference
};

// Always check the upload result
const filePath = await uploadFile(myFile);
if (!filePath) {
  console.error('File was not uploaded successfully');
}

-- Check your RLS policies in the Supabase SQL editor
-- Example policy that might be too restrictive:
CREATE POLICY "Users can view their own files"
ON storage.objects FOR SELECT
USING (auth.uid() = owner);

-- If the file doesn't have an owner set or the owner doesn't match,
-- the file won't be accessible.

-- You might need a more permissive policy:
CREATE POLICY "Anyone can view public files"
ON storage.objects FOR SELECT
USING (bucket_id = 'public-bucket-name');

// Problem: File with spaces in name
const problemFile = 'my document.pdf'; // Contains space

// Solution 1: Encode the path
const encodedPath = encodeURIComponent('my document.pdf');
// Or use the storage API which handles encoding internally

// Solution 2: Use a consistent naming convention
// Replace spaces and special characters
const safeFileName = file.name
  .toLowerCase()
  .replace(/s+/g, '-')
  .replace(/[^a-z0-9-.]/g, '');

// Solution 3: When constructing URLs manually:
const publicUrl = supabase.storage
  .from('bucket')
  .getPublicUrl('path/with spaces/file.pdf');
// The getPublicUrl method handles encoding for you

const getFileWithFallback = async (filePath, fallbackPath) => {
  try {
    const { data, error } = await supabase.storage
      .from('bucket')
      .download(filePath);

    if (error) {
      if (error.message.includes('Object not found')) {
        console.warn('File ' + filePath + ' not found, using fallback');
        // Try fallback file
        return await supabase.storage
          .from('bucket')
          .download(fallbackPath);
      }
      throw error;
    }

    return { data, error: null };
  } catch (err) {
    console.error('Error in getFileWithFallback:', err);
    return { data: null, error: err };
  }
};

// Usage with default avatar example
const userAvatar = await getFileWithFallback(
  'avatars/' + userId + '.jpg',
  'avatars/default.jpg'
);