FTP file upload failure

更新时间:
复制 MD 格式

When you upload files to an FTP server (your web hosting instance) using an FTP client, you may encounter an error such as Failed to convert command to 8 bit charset or 451 No mapping for the Unicode character exists in the target multi-byte code page. This issue is often caused by inconsistent character encodings between the FTP client and the FTP server. This topic describes the cause of this issue and its solution.

Symptoms

When you use an FTP client to upload files to your web hosting instance, you may encounter one of the following errors:

  • The FTP client returns the error Failed to convert command to 8 bit charset.

    Status: Connecting to xxx
    Status: Connection established, waiting for welcome message...
    Status: Insecure server, it does not support FTP over TLS.
    Status: Logged in
    Status: Retrieving directory listing...
    Status: Received invalid character, disabling UTF-8. Please select UTF-8 from the Site Manager to force UTF-8.
    Status: Calculating server time offset...
    Command: MDTM ÇëÌÈÁÌÒ.txt
    Error: Failed to convert command to 8 bit charset
    Status: Directory listing of "/" successful
  • The FTP client returns the error 451 No mapping for the Unicode character exists in the target multi-byte code page. In addition, Windows Explorer displays an FTP Folder Error dialog box with the message "An error occurred copying a file to the FTP Server". The details show the following FTP responses: 200 Type set to I., 227 Entering Passive Mode, and 451 No mapping for the Unicode character exists in the target multi-byte code page..

Possible cause

Inconsistent character encodings between the FTP client and the FTP server (your web hosting instance) can cause file upload failures. To resolve this issue, change the character set in your FTP client.

Solution

  1. Launch FileZilla.
    This topic uses FileZilla as an example. The steps for other FTP clients are similar.
  2. In the top menu bar, select File (F) > Site Manager (S).

  3. In the Site Manager dialog box, under the Select Entry section, click the affected site.

  4. Click the Charset tab, select Force UTF-8 (U), and then click Connect (C).

  5. Try uploading the file to your web hosting instance again.

    • If the upload succeeds, the issue is resolved.

    • If the upload fails, submit a ticket.