Navigating MySQL Error 1023: A Guide to Resolving ‘Error on Close’

MySQL Error 1023 with the message SQLSTATE: HY000 (ER_ERROR_ON_CLOSE) Error on close of '%s' (errno: %d) can be somewhat cryptic, but it generally points to issues that occur when MySQL is trying to close a file. The %s in the message is a placeholder for the filename, and %d is the placeholder for the error number which can give you more insight into the underlying issue. Let’s delve into the potential causes of this error and how to fix them.

Possible Causes and Solutions

File System Limitations

One of the reasons you might encounter this error is because of the limitations of your file system, such as the number of open files that it can handle.

You can increase the limit of open files in your system. This is done differently based on your operating system.

On a Linux system, you can view the current limit with ulimit -n and set a new limit with ulimit -n [new limit]. For persistent changes, you may need to edit /etc/security/limits.conf.

File Permissions

If MySQL doesn’t have the correct permissions to work with the necessary files, it may throw Error 1023 when attempting to close a file.

Check the permissions of the file MySQL is trying to close and adjust them accordingly.


# To give the MySQL user ownership of a file, you might use:
sudo chown mysql:mysql /path/to/mysql/file
# To adjust file permissions, you might use:
sudo chmod 660 /path/to/mysql/file

Disk Space Issues

A lack of available disk space can also result in Error 1023. If MySQL is unable to write to a file because the disk is full, it may also have issues closing the file.

Check your disk space with a tool like df and free up space if necessary.


df -h
# Look for file systems that are close to 100% usage and free up space.

Corrupted Files

Corrupted files can prevent MySQL from closing them properly, leading to Error 1023.

Identify any corrupted files and restore them from backups if available.

Server Misconfiguration

Misconfiguration in your MySQL server settings can also be the cause. For instance, if the tmpdir setting points to a non-writable directory, MySQL might be unable to close temporary files.

Review your MySQL configuration file for any incorrect settings that might affect file operations.



Ensure that the tmpdir is writable by the MySQL process.


To diagnose and fix MySQL Error 1023, you should:

  1. Check and adjust the file system’s limits on open files.
  2. Verify and correct file permissions for the files MySQL is working with.
  3. Ensure there is enough disk space available for MySQL operations.
  4. Look for and repair any corrupted files that MySQL is attempting to close.
  5. Review and rectify any misconfigurations in your MySQL server settings.

By following these steps, you should be able to resolve Error 1023 and maintain a healthy MySQL server environment. If the error persists, consider consulting the MySQL error codes and messages documentation or seeking help from the MySQL community for more specific guidance.

Leave a Comment