--- title: "일반적인 문제" slug: "objectstorage-troubleshoot-common" tags: ["Object Storage", "VPC"] updated: 2026-09-17T09:09:40Z published: 2026-09-17T09:09:40Z canonical: "guide-fin.ncloud-docs.com/objectstorage-troubleshoot-common" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 일반적인 문제 Object Storage 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. ## 업로드 오류 암호화 설정이 적용된 버킷에 파일 업로드 시 오류가 발생합니다. #### 원인 메인 계정의 API Key를 사용하여 암호화 설정이 적용된 버킷 또는 객체에 대해 업로드 API를 호출할 경우, 권한 관련 오류가 발생할 수 있습니다. #### 해결 방법 메인 계정의 API Key로 업로드 API를 호출한 것은 아닌지 확인해 주십시오. 서브 계정을 생성한 후 서브 계정의 API Key를 사용하여 요청해 주십시오. 더 자세한 설명은 [암호화 설정(KMS)](/docs/objectstorage-use-bucket#%EC%95%94%ED%98%B8%ED%99%94%EC%84%A4%EC%A0%95KMS)과 [서브 계정 생성 및 관리](/docs/subaccount-use)를 참조해 주십시오. ## 여러 파일 업로드, 다운로드 - 콘솔에서 여러 파일을 한 번에 다운로드하거나 업로드할 수 없습니다. - 콘솔에서 파일이 1개씩만 업로드됩니다. - 콘솔에서 파일이 1개씩만 다운로드됩니다. #### 원인 콘솔에서는 버킷 내 파일을 1개 단위로만 업로드, 다운로드할 수 있습니다. #### 해결 방법 여러 개의 파일을 한 번에 업로드하거나 다운로드하려면 S3 브라우저를 사용해야 합니다. S3 브라우저를 연동하고 설정하는 방법은 다음과 같습니다. 1. [API 인증 키 생성 및 Amazon S3 연동](/docs/objectstorage-integration#API%EC%9D%B8%EC%A6%9D%ED%82%A4%EC%83%9D%EC%84%B1%EB%B0%8FAmazonS3%EC%97%B0%EB%8F%99)을 참조하여 S3 브라우저를 연동해 주십시오. 2. S3 브라우저를 실행해 주십시오. 3. **Menu** > **Account** > **Add New Account** 메뉴를 차례대로 클릭해 주십시오. 4. 다음과 같이 설정해 주십시오. - Account Type: S3 Compatible Storage - REST Endpoint: kr.object.fin-ncloudstorage.com - Access Key ID: 네이버 클라우드 플랫폼 계정의 Access Key ID 입력 - Secret Access Key: 네이버 클라우드 플랫폼 계정의 Secret Access Key 입력 - Use secure transfer(SSL/TLS): 선택 5. **[Task]** 탭에서 정상적으로 연결이 되는지 확인해 주십시오. 6. 파일 업로드/다운로드를 수행해 주십시오. 참고 Acceess Key ID와 Secret Access Key는 네이버 클라우드 플랫폼 콘솔의 우측 상단 **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** > **API 인증키** 메뉴에서 확인할 수 있습니다. ## 404 NoSuchKey 오류 404 NoSuchKey 오류가 발생합니다. #### 원인 실제 저장되는 키 값에 특수 문자 또는 공백이 포함되어 있거나 경로 앞에 슬래시(/)가 포함되어 있으면 오류가 발생할 수 있습니다. #### 해결 방법 정확한 객체명을 확인해야 합니다. 객체명을 확인하는 방법은 다음과 같습니다. - API로 확인하려면, [ListObjectsV2 API](https://api-fin.ncloud-docs.com/docs/storage-objectstorage-listobjects2)를 호출해 주십시오. - CLI로 확인하려면 명령어를 다음과 같이 입력해 주십시오. ``` aws s3api --endpoint-url=https://kr.object.fin-ncloudstorage.com list-objects-v2 --bucket --query 'Contents[].Key' ``` 참고 더 자세한 내용은 [Object Storage CLI 가이드](https://cli-fin.ncloud-docs.com/docs/guide-objectstorage)를 참조해 주십시오. - 반환되는 객체가 많은 경우, `--prefix` 옵션을 사용하여 결과를 필터링해 주십시오. ## 파일 접근 권한 최상위 폴더가 '공개'임에도 파일 업로드 시 접근 권한이 없다는 메시지가 나타납니다. #### 원인 객체가 업로드되는 폴더의 권한과 관계없이 파일 업로드 시 '공개 안함' 상태로 파일이 업로드됩니다. 파일의 공개 권한이 '공개 안함'일 경우, 해당 오류가 발생할 수 있습니다. #### 해결 방법 S3 API 등을 통해 객체를 업로드한 후, 객체의 접근 제한 설정을 'public-read'로 변경해 주십시오. - 객체에 적용할 ACL을 설정하는 방법은 [PutObjectACL](https://api-fin.ncloud-docs.com/docs/storage-objectstorage-putobjectacl)을 참조해 주십시오. - 접근 제한 목록은 Object Storage API 가이드의 [접근 제어 목록(ACL)](https://api-fin.ncloud-docs.com/docs/storage-objectstorage#%EC%A0%91%EA%B7%BC%EC%A0%9C%EC%96%B4%EB%AA%A9%EB%A1%9DACL)을 참조해 주십시오. 콘솔에서 객체를 업로드할 경우에는 업로드 창에서 **[권한 및 메타 데이터 설정]** 버튼을 클릭하면 공개 여부를 선택할 수 있습니다. ## CORS 오류 CORS (Cross-origin resource sharing) 오류가 발생합니다. #### 원인 CORS 설정에 문제가 있을 경우 발생합니다. #### 해결 방법 CLI로 버킷의 CORS 설정을 확인하고 테스트하는 방법은 다음과 같습니다. 1. CORS 규칙 조회 다음 명령어를 실행하여 CORS 설정이 올바르게 구성되었는지 확인해 주십시오. ``` aws --endpoint-url=https://kr.object.fin-ncloudstorage.com s3api get-bucket-cors --bucket ``` 2. CORS 설정 테스트 curl을 통해 OPTION 요청을 보내고, Origin 헤더와 Access-Control-Request-Method 헤더를 설정하여 CORS 설정을 확인해 주십시오. ``` i https://kr.object.fin-ncloudstorage.com// -H "Access-Control-Request-Method: " --request OPTIONS -H "Origin: " ``` 3. 응답 확인 응답 헤더에 `Access-Control-Allow-Origin` 헤더와 `Access-Control-Allow-Methods` 헤더가 있는지 확인해 주십시오. 예를 들어, 다음과 같은 헤더가 있으면 CORS 요청이 허용되었다는 뜻입니다. `Access-Control-Allow-Origin: <origin>` `Access-Control-Allow-Methods: <method>` API로 CORS 설정을 확인하는 방법은 [OptionsObjectCORS API 가이드](https://api-fin.ncloud-docs.com/docs/storage-objectstorage-optionsobjectcors)를 참조해 주십시오. ## Access Denied 오류 Java SDK를 이용하여 Object Storage 버킷에 파일을 업로드하면 Access Denied 오류가 발생합니다. #### 원인 API로 파일 업로드 및 버킷 생성 시 권한이 없는 상태로 생성되어서 발생하는 문제입니다. #### 해결 방법 - 파일 업로드 또는 폴더 생성 시 접근 제어 목록(ACL)을 설정할 수 있습니다. 자세한 내용은 [PutBucketACL](https://api-fin.ncloud-docs.com/docs/storage-objectstorage-putbucketacl)을 참조해 주십시오. - 업로드한 객체의 공개 설정은 콘솔에서 폴더 단위로 수행할 수 있습니다. 자세한 설명은 [Java용 AWS SDK](/docs/storage-storage-8-1)를 참조해 주십시오. ## 버킷 삭제 후 멀티파트 업로드 잔여 문제 버킷을 삭제했으나 멀티파트 업로드(Multipart-upload)가 남아 있습니다. #### 원인 멀티파트 업로드를 완료하지 않을 경우, 잔여 파일이 버킷에 남게 됩니다. 잔여 파일은 버킷 용량에 포함되어 과금되므로 불완전한 멀티파트 객체를 삭제해야 합니다. #### 해결 방법 API를 호출하여 불완전한 멀티파트 객체를 확인하고 삭제하는 방법은 다음과 같습니다. 1. 업로드가 취소되었거나 완료되지 않은 멀티파트 업로드 정보를 조회해 주십시오([ListMultipartUploads](https://api-fin.ncloud-docs.com/docs/storage-objectstorage-listmultipartuploads) 참조). 2. 멀티파트 업로드 중 완료되지 않은 업로드를 중지한 후 삭제해 주십시오([AbortMultipartUpload](https://api-fin.ncloud-docs.com/docs/storage-objectstorage-abortmultipartupload) 참조). CLI에서 미완료 멀티파트 업로드를 확인하고 삭제하는 방법은 [미완료 멀티파트 업로드 삭제](https://cli-fin.ncloud-docs.com/docs/guide-objectstorage#%EB%AF%B8%EC%99%84%EB%A3%8C%EB%A9%80%ED%8B%B0%ED%8C%8C%ED%8A%B8%EC%97%85%EB%A1%9C%EB%93%9C%EC%82%AD%EC%A0%9C)를 참조해 주십시오. ## 데이터 삭제 불가 Object Storage 버킷의 데이터가 삭제되지 않습니다. #### 원인 객체 잠금 상태인 데이터는 삭제할 수 없습니다. #### 해결 방법 객체 잠금 상태인 데이터는 삭제할 수 없고, 객체 잠금은 만료일 전까지 객체 잠금을 해제할 수 없습니다. 데이터 삭제뿐만 아니라 회원 탈퇴에도 영향을 주므로, 객체 잠금을 설정하기 전에는 주의해 주십시오. 참고 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.