[v6.9.x-v6.10.0] Method Collection::newCollection does not exist - SmartAlbumResource

[benhz]

Lychee version

V6.10.0

Did you check the latest Lychee version?

No, I am not using the latest version

Which PHP version are you using?

PHP 8.4

Detailed description of the problem

Bug Description

Affected Versions: v6.9.x - v6.10.0
Working Version: v6.7.1

When accessing albums or uploading photos, Lychee throws a critical error that breaks core functionality:

Method Illuminate\Support\Collection::newCollection does not exist.

Error Logs

From v6.9.4 and v6.10.0:

[2025-11-17 18:58:09] production.ERROR: 
Illuminate\Support\Collection::__call:115 
Method Illuminate\Support\Collection::newCollection does not exist.
App\Http\Resources\Models\SmartAlbumResource::getByQuery:74
[2025-11-17 19:00:26] production.ERROR:

App\View\Components\Meta::getByQuery:74

Method Illuminate\Support\Collection::newCollection does not exist.

(View: /var/www/html/Lychee/resources/views/vueapp.blade.php)

Environment

• Versions Tested: v6.10.0, v6.9.4 (both broken)
• Docker Images: lycheeorg/lychee:latest, lycheeorg/lychee:v6.9.4
• Database: PostgreSQL 15+ (external with SSL)
• Storage: S3-compatible object storage (Qiniu Cloud)
• PHP: 8.4
• Platform: Linux/Docker

Configuration

services:
  lychee:
    image: lycheeorg/lychee:v6.10.0
    environment:
      DATABASE_URL: "postgresql://user:pass@host:5432/lychee?sslmode=require"
      S3_ENABLED: true
      AWS_BUCKET: "bucket"
      AWS_ENDPOINT: "https://s3.region.provider.com"

Steps to Reproduce

1. Deploy Lychee v6.10.0 or v6.9.4 using Docker
2. Configure PostgreSQL database with SSL
3. Configure S3-compatible storage
4. Complete initial setup
5. Try to access any album or upload a photo
6. Result: 500 error - albums cannot be viewed, photos cannot be displayed

Expected vs Actual Behavior

Expected: Albums display normally, photos are viewable (as in v6.7.1)

Actual:

• 500 Internal Server Error when accessing albums
• Smart albums throw exceptions
• Photos upload but cannot be viewed
• Browser shows: {"message": "Server Error", "exception": "BadMethodCallException"}

Root Cause Analysis

The code attempts to call newCollection() on an Illuminate\Support\Collection instance, but this method only exists on Eloquent Model classes.

Affected code:

• App\Http\Resources\Models\SmartAlbumResource::getByQuery() line 74
• App\View\Components\Meta::getByQuery() line 74

This is likely a Laravel API misuse where the code expects a Model but receives a Collection.

Version Testing

Version	Status	Notes
v6.10.0	❌ Broken	Latest, error present
v6.9.4	❌ Broken	Same error
v6.7.1	✅ Works	All features functional

Workaround

Downgrade to v6.7.1:

# In docker-compose.yml
image: lycheeorg/lychee:v6.7.1
Then restart
docker-compose down

docker pull lycheeorg/lychee:v6.7.1

docker-compose up -d

No database migrations needed - fully compatible.

Impact

Severity: CRITICAL

Affects:

• ✅ All PostgreSQL database users
• ✅ All S3/object storage users
• ✅ Fresh installations of v6.9.x-v6.10.0
• ✅ Users upgrading from v6.7.x

Core functionality completely broken:

• Cannot view albums
• Cannot view uploaded photos
• Cannot use smart albums
• Makes these versions entirely unusable

Suggested Fix

Review collection handling in SmartAlbumResource and Meta components:

// ❌ Current (problematic)
$results = Model::query()->get();  // Returns Collection
$collection = $results->newCollection($data);  // Error!
// ✅ Option 1: Call on Model

$model = new Model();

$collection = $model->newCollection($data);
// ✅ Option 2: Use collect()

$collection = collect($data);
// ✅ Option 3: Use Collection directly

$results = Model::query()->get();  // Already a Collection

Additional Info

• Error is consistent across multiple clean installations
• No configuration changes resolve the issue
• Bug appears to be a regression introduced in v6.9.x
• Framework-level error, not environmental

---

Request: Please prioritize this for v6.10.1 as it's a critical regression blocking users from using recent versions.

Thank you for maintaining Lychee! Happy to provide additional logs or testing if needed.

Steps to reproduce the issue

1. Deploy Lychee v6.10.0 or v6.9.4 using Docker
2. Configure PostgreSQL database with SSL connection
3. Configure S3-compatible object storage (e.g., Qiniu Cloud)
4. Complete initial setup and create admin account
5. Navigate to any album page or try to upload a photo
6. Error appears: 500 Internal Server Error with "Method Collection::newCollection does not exist"

Diagnostics [REQUIRED]

Self-diagnosis
info
Full directory permission check is disabled
info
git (software) is not available.
info
Have you considered supporting Lychee? :)
Info
Lychee Version (tag): v6.7.1 (d5ae43d) -- 10 tags behind v6.10.1 (0 seconds ago)
DB Version: 6.7.1
Docker: false
composer install: --no-dev
APP_ENV: production
APP_DEBUG: false
APP_URL: set
APP_DIR: default
LOG_VIEWER_ENABLED: true
System: Linux
PHP Version: 8.4.10
PHP User agent: Lychee/6 (https://lycheeorg.dev/)
Timezone: Asia/Shanghai
Max uploaded file size: 100M
Max post size: 100M
Chunk size: 25.60 MB
Max execution time: 3600
PostgreSQL Version: PostgreSQL 17.5 (Ubuntu 17.5-1.pgdg22.04+1) on x86_64-pc-linux-gnu, compiled by gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0, 64-bit
exec() Available: yes
Imagick Available: 1
Imagick Enabled: 1
Imagick Version: 1691
GD Version: 2.3.3
Number of foreign key: 14 found.

Space
Lychee total space: 243.30 MB
Upload folder space: 15.62 MB
System total space: 39.26 GB
System free space: 23.91 GB (60%)

Configuration
version: 060701
check_for_updates: 0
sorting_photos_col: taken_at
sorting_photos_order: ASC
sorting_albums_col: max_taken_at
sorting_albums_order: ASC
imagick: 1
skip_duplicates: 0
small_max_width: 0
small_max_height: 360
medium_max_width: 1920
medium_max_height: 1080
lang: en
image_overlay_type: desc
default_license: none
compression_quality: 90
grants_full_photo_access: 1
delete_imported: 0
mod_frame_enabled: 1
mod_frame_refresh: 30
thumb_2x: 1
small_2x: 1
medium_2x: 1
landing_page_enable: 0
search_public: 0
hide_version_number: 0
recent_age: 1
grants_download: 0
photos_wraparound: 1
map_display: 0
zip64: 1
map_display_public: 0
map_provider: Wikimedia
map_include_subalbums: 0
update_check_every_days: 3
has_exiftool: 1
share_button_visible: 0
import_via_symlink: 0
has_ffmpeg: 1
location_decoding: 0
location_decoding_timeout: 30
location_show: 1
location_show_public: 0
rss_enable: 0
rss_recent_days: 7
rss_max_items: 100
prefer_available_xmp_metadata: 0
editor_enabled: 1
lossless_optimization: 0
local_takestamp_video_formats: .avi|.mov
log_max_num_line: 1000
unlock_password_photos_with_url_param: 0
nsfw_visible: 1
nsfw_blur: 0
nsfw_warning: 0
nsfw_warning_admin: 0
nsfw_banner_override:
map_display_direction: 1
album_subtitle_type: oldstyle
upload_processing_limit: 4
new_photos_notification: 0
zip_deflate_level: 6
default_album_protection: 1
album_decoration: layers
album_decoration_orientation: row
allow_username_change: 1
auto_fix_orientation: 1
use_job_queues: 0
random_album_id: starred
use_last_modified_date_when_no_exif_date: 0
layout: justified
date_format_photo_thumb: M j, Y, g:i:s A e
date_format_photo_overlay: M j, Y, g:i:s A e
date_format_sidebar_uploaded: M j, Y, g:i:s A e
date_format_sidebar_taken_at: M j, Y, g:i:s A e
date_format_hero_min_max: F Y
date_format_hero_created_at: M j, Y, g:i:s A T
date_format_album_thumb: M Y
upload_chunk_size: 0
nsfw_banner_blur_backdrop: 0
search_pagination_limit: 300
search_minimum_length_required: 4
photo_layout_justified_row_height: 320
photo_layout_masonry_column_width: 300
photo_layout_grid_column_width: 250
photo_layout_square_column_width: 200
photo_layout_gap: 12
display_thumb_album_overlay: always
display_thumb_photo_overlay: hover
default_album_thumb_aspect_ratio: 1/1
use_album_compact_header: 0
back_button_enabled: 0
back_button_text: Return to Home
SA_random_thumbs: 0
login_required: 0
enable_unsorted: 1
enable_starred: 1
enable_recent: 1
enable_on_this_day: 1
login_required_root_only: 1
dark_mode_enabled: 1
low_quality_image_placeholder: 1
show_keybinding_help_popup: 1
show_keybinding_help_button: 1
disable_se_call_for_actions: 0
enable_se_preview: 0
slideshow_timeout: 5
keep_original_untouched: 1
timeline_photos_enabled: 1
timeline_photos_public: 0
timeline_photos_granularity: day
timeline_photos_order: taken_at
timeline_photos_layout: square
timeline_photos_pagination_limit: 200
timeline_albums_enabled: 1
timeline_albums_public: 0
timeline_albums_granularity: year
timeline_left_border_enabled: 1
timeline_photo_date_format_year: Y
timeline_photo_date_format_month: M Y
timeline_photo_date_format_day: j M Y
timeline_photo_date_format_hour: g:i
timeline_album_date_format_year: Y
timeline_album_date_format_month: M Y
timeline_album_date_format_day: j M
hide_nsfw_in_smart_albums: 1
hide_nsfw_in_frame: 1
hide_nsfw_in_map: 1
hide_nsfw_in_search: 1
search_photos_layout: square
hide_nsfw_in_rss: 1
hide_nsfw_in_timeline: 1
number_albums_per_row_mobile: 3
cache_enabled: 0
cache_ttl: 86400
low_number_of_shoots_per_day: 10
medium_number_of_shoots_per_day: 50
high_number_of_shoots_per_day: 100
maintenance_processing_limit: 5000
disable_recursive_permission_check: 1
exif_disabled_for_all: 0
file_name_hidden: 0
default_old_settings: 0
default_expert_settings: 0
default_all_settings: 0
client_side_favourite_enabled: 0
disable_thumb_download: 1
disable_thumb2x_download: 1
disable_small_download: 0
disable_small2x_download: 0
disable_medium_download: 0
disable_medium2x_download: 0
temporary_image_link_enabled: 0
temporary_image_link_when_logged_in: 0
temporary_image_link_when_admin: 0
temporary_image_link_life_in_seconds: 86400
secure_image_link_enabled: 0
SA_override_visibility: 0
TA_override_visibility: 0
enable_colour_extractions: 0
colour_extraction_driver: farzai
home_page_default: gallery
flow_enabled: 1
flow_public: 0
flow_base:
flow_max_items: 10
flow_strategy: auto
flow_include_sub_albums: 0
flow_include_photos_from_children: 0
flow_open_album_on_click: 0
flow_display_open_album_button: 0
flow_highlight_first_picture: 1
flow_min_max_enabled: 1
flow_display_statistics: 1
flow_compact_mode_enabled: 1
flow_image_header_enabled: 1
flow_image_header_cover: cover
flow_image_header_height: 24
flow_carousel_enabled: 1
flow_carousel_height: 6
date_format_flow_published: M j, Y, g:i:s A e
date_format_flow_min_max: F Y
flow_blur_nsfw_enabled: 1
hide_nsfw_in_flow: 1
skip_duplicates_early: 1
sync_delete_missing_photos: 0
sync_delete_missing_albums: 0
sync_dry_run: 1
gallery_header_enabled: 0
gallery_header_logged_in_enabled: 0
gallery_header:
gallery_header_bar_transparent: 1
gallery_header_bar_gradient: 1
import_via_url_forbidden_localhost: 1
import_via_url_forbidden_local_ip: 1
import_via_url_require_https: 1
import_via_url_forbidden_ports: 1
is_scroll_to_navigate_photos_enabled: 1
is_swipe_vertically_to_go_back_enabled: 1

Browser & System [REQUIRED]

Browser:

• Google Chrome 142.0.0.0 (macOS)
• Tested and confirmed on multiple browsers

Client System:

• macOS 10.15.7

Server System:

• OS: Linux CentOS 7
• Container: Podman/Docker
• PHP: 8.4.10
• Database: PostgreSQL 17.5 (External server with SSL)
• Storage: S3-compatible object storage (Qiniu Cloud, China South region)

Deployment:

• Method: Docker deployment
• Image: lycheeorg/lychee:v6.10.0 / lycheeorg/lychee:v6.9.4 (broken)
• Working image: lycheeorg/lychee:v6.7.1
• Reverse proxy: Nginx with HTTPS

Error reproduction:

• Error is consistent across all browsers (Chrome, Firefox, Safari)
• Error occurs on both desktop and mobile devices
• Error appears immediately on both fresh installations and upgrades from v6.7.1
• Issue is 100% reproducible with PostgreSQL + S3 configuration

Please confirm (incomplete submissions will not be addressed)

• I have provided easy and step-by-step instructions to reproduce the bug.
• I understand my bug report will be removed if I haven't met the criteria above.
• I understand that if I am requested to provide more information, I must do so within 14 days or the bug report will be closed.

[ildyria]

So something in your set-up is breaking because I am running latest on my prod and I do not observe this, and trust me I would have fixed it instantly if I had found it... And while you said it is 100% reproducible, then I would challenge you to write a test to exhibit it.

In my opinion, it is a combination of factors between your settings and an effective bug. I had a look in the diagnostic you provided and I did not see anything suspicious. So that is ... interesting. 🤔

[ildyria]

Do you have only portrait pictures?

[ildyria]

Tested, what is breaking is only the smart albums with only portrait photos.

[ildyria]

Fixed by #3816

[benhz]

I can confirm that the issue was indeed triggered only when the smart album contained exclusively portrait photos.

Really appreciate the fast response and your continued maintenance of Lychee! 🙏