Skip to content

fix: deduplicate photos in tag album listings #4328

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 5 commits into
base: master
Choose a base branch
from
+56 −6
Open

fix: deduplicate photos in tag album listings #4328

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
bdf903a
Initial plan
Copilot Apr 29, 2026
46e2e51
fix: deduplicate tag album photos by adding distinct() to query
Copilot Apr 29, 2026
72f04c3
test: clarify duplicate photo assertion in tag album test
Copilot Apr 29, 2026
93fa5fd
fix: replace distinct() with whereIn subquery to avoid PostgreSQL crash
Copilot Apr 29, 2026
4a66bfc
fix: use PhotoBuilder import instead of FQCN in PHPDoc
Copilot Apr 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions app/Relations/HasManyPhotosByTag.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,12 @@ public function addEagerConstraints(array $albums): void
)
->where(fn (Builder $q) => $this->getPhotoIdsWithTags($q, $tag_ids, $album->is_and));
}

// The LEFT JOIN with photo_album (added by applySearchabilityFilter/applySensitivityFilter
// for access control checks) produces one row per album membership. Since a photo can
// belong to multiple regular albums, this causes duplicate rows in the result. Adding
// DISTINCT ensures each photo appears only once.
$this->getRelationQuery()->distinct();
}

/**
Expand Down
27 changes: 27 additions & 0 deletions tests/Feature_v2/Album/AlbumPhotosEndpointTest.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@

namespace Tests\Feature_v2\Album;

use App\Models\Album;
use Tests\Feature_v2\Base\BaseApiWithDataTest;

/**
Expand Down Expand Up @@ -125,4 +126,30 @@ public function testGetAlbumPhotosMissingAlbumId(): void
'message' => 'The album id field is required.',
]);
}

public function testTagAlbumPhotosNoDuplicatesWhenPhotoInMultipleAlbums(): void
{
// Regression test for: tag album photo listing returns duplicate entries.
// When a photo belongs to multiple regular albums, the LEFT JOIN with
// photo_album in applySearchabilityFilter produces one row per album
// membership, causing duplicate photos in the tag album response.

$this->actingAs($this->userMayUpload1);

// photo1 is already in album1 and has the 'test' tag.
// tagAlbum1 is linked to the 'test' tag.
// Add photo1 to a second album to trigger the duplicate via the photo_album JOIN.
$extraAlbum = Album::factory()->as_root()->owned_by($this->userMayUpload1)->create();
$this->photo1->albums()->attach($extraAlbum->id);

$response = $this->getJsonWithData('Album::photos', ['album_id' => $this->tagAlbum1->id]);
$this->assertOk($response);

$photos = $response->json('photos');
$photoIds = array_column($photos, 'id');

// Each photo must appear exactly once.
$this->assertSame(count(array_unique($photoIds)), count($photoIds), 'Tag album must not return duplicate photos');
$this->assertContains($this->photo1->id, $photoIds);
}
}
Loading