Gallery: 疑难解答：修订间差异

来自站长百科
跳转至： 导航、​ 搜索
（新页面: = Troubleshooting Gallery 2 = More links on troubleshooting Gallery 2: Category:Gallery 2:Troubleshooting == Do this first == # Clear your Gallery caches! - See [[Gallery:FAQ#How_ca...）
 
无编辑摘要
 
（未显示同一用户的7个中间版本）
第1行： 第1行：
= Troubleshooting Gallery 2 =
= Gallery2疑难解答 =
More links on troubleshooting Gallery 2: [[:Category:Gallery 2:Troubleshooting]]
Gallery2疑难解答的更多链接：[[:Category:Gallery 2:Troubleshooting]]


== Do this first ==
== 需要预先做好的工作 ==
# Clear your Gallery caches! - See [[Gallery:FAQ#How_can_I_clear_cached_data.3F|FAQ: How can I clear cached data?]]
# 清除Gallery缓存！-参见[[Gallery:FAQ#如何清除缓存数据？|如何清除缓存数据？]]
# Ensure the Gallery application files are intact! - [[Gallery:FAQ#How_can_I_make_sure_that_my_installation_files_are_all_intact.3F|FAQ: How can I make sure that my installation files are all intact?]]
# 确保Gallery应用程序文件完好无损！-[[Gallery:FAQ#如何确保安装文件完整无损？|常见问题：如何确保安装文件完整无损？]]
# Clear your web-browser caches (cookies, page cache)!
# 清除web浏览器缓存（cookies及页面缓存）！
# Enable 'buffered' debug mode to ensure that no important warnings or details are hidden
# 启用'buffered'debug模式以确保没有遗漏任何重要警告或详细信息


'''Important Note: ''' If you are not logged in as administrator, you need to enable 'buffered' '''debug mode''' to see the error name and the details. See: [[Gallery:FAQ#How_to_set.2Fuse_Gallery_in_debug_mode.3F|FAQ: How to enable Gallery's debug mode?]]. If 'buffered' debug mode does not show anything, you can try the 'immediate' or 'logged' debug mode.
'''重要提示：''' 如果你没有以管理员身份登录的话，你需要启用'buffered''''debug模式'''来检查错误名称及详细信息。参见：[[Gallery:FAQ#如何设置/使用Gallery的debug模式？|常见问题：如何设置/使用Gallery的debug模式？]]。如果'buffered' debug模式没有任何显示的话，你可以尝试'immediate'或'logged' debug模式。


== Troubleshooting by... ==
== 解决手段... ==
You can either try to find your specific issue by looking for a specific 'error name' or by locating your issue in the categorized symptoms.
你可以查找相应特定的'错误名称'来确定遇到的问题，或者在经过分类的症状中对号入座。


=== Error Name ===
=== 错误名称（Error Name） ===
Do you get the error just when browsing to the frontpage of your Gallery? If the error only occurs when browsing to a specific page / album or when attempting a special action, you should first try to 'troubleshoot by symptom / attempted action' (see below).
是不是在访问Gallery首页时就发生了错误？如果错误仅当浏览特定页面/相册时发生或尝试进行某特殊动作时发生的话，你应当先通过错误症状/尝试进行的动作的分类来尝试解决问题（见下表）。


{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Error Name!!Solution
!错误名称!!解决办法
|-
|-
|ERROR_PLATFORM_FAILURE
|ERROR_PLATFORM_FAILURE
|[[Gallery:FAQ#How_can_I_fix_the_filesystem_permissions_of_the_Gallery_storage_folder.3F|FAQ: How can I fix the filesystem permissions of the Gallery storage folder?]]
|[[Gallery:FAQ#如何修复Gallery存储文件夹文件系统权限问题？|常见问题：如何修复Gallery存储文件夹文件系统权限问题？]]
|-
|-
|ERROR_OBSOLETE_DATA
|ERROR_OBSOLETE_DATA
|[[Gallery:FAQ#How_can_I_clear_cached_data.3F|FAQ: How can I clear cached data?]]
|[[Gallery:FAQ#如何清除缓存数据？|常见问题：如何清除缓存数据？]]
|-
|-
|ERROR_REQUEST_FORGED
|ERROR_REQUEST_FORGED
|
|
* Logout or clear your browser cookies and then try again.
* 登出或清除浏览器cookies并重试。
* If your Gallery is integrated in a blog, portal, forum, ... ensure that you got the latest version of the integration.
* 如果你的Gallery被整合在了一个blog，门户或论坛等之中的话，请确保是使用的整合是最新版本的。
|-
|-
|ERROR_STORAGE_FAILURE
|ERROR_STORAGE_FAILURE
|
|
* Usually either a database table got corrupted or the database connection does not work anymore.
* 一般情况是，某数据库表格崩溃或数据库连接无法运作。
* Enable 'buffered' debug mode to see the details, refresh the page and then search for 'error' in the page contents.
* 启用'buffered' debug模式来检查详细信息，刷新页面并在页面内容中搜索'error'。
* If a specific table got corrupted, you can try to repair it in phpmyadmin or with 'mysqlchk' / 'misamchk' in the command line if you have shell access to the server.
* 如果某特定表格崩溃了，而你具有服务器shell访问权限的话，就可以尝试在phpmyadmin中或使用命令行中的'mysqlchk'/'misamchk'来进行修复。
* Maybe your webhost limits how many database queries can be done per hour. See [[Gallery:FAQ#I_seem_to_be_running_into_some_sort_of_MySQL_query_limit.2C_is_there_anything_that_can_be_done.3F|FAQ: I seem to be running into some sort of MySQL query limit, is there anything that can be done?]]
* 或许你的webhost限制了单位小时内数据库查询可执行数。参见[[Gallery:FAQ#我可能碰上了某种MySQL查询限制，该怎么办呢？|常见问题：我可能碰上了某种MySQL查询限制，该怎么办呢？]]
* [[Gallery:FAQ#I_get_the_error_.27Illegal_mix_of_collations.27.2C_what_should_I_do.3F|FAQ: I get the error 'Illegal mix of collations', what should I do?]]
* [[Gallery:FAQ#发生了'Illegal mix of collations'这样的错误，该怎么办？|常见问题：发生了'Illegal mix of collations'这样的错误，该怎么办？]]
* [[Gallery:FAQ#Why_do_I_get_a_MySQL_.22Can.27t_connect_to_local_MySQL_server_through_socket.22_error.3F|FAQ: Why do i get a MySQL 'Can't connect to local MySQL server through socket' error?]]
* [[Gallery:FAQ#为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？|常见问题：为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？]]
|-
|-
|ERROR_BAD_PARAMETER
|ERROR_BAD_PARAMETER
|Did you customize / edit any template (.tpl) files or are you using a 3rd party theme or module? Try to rule out the possibility of being broken by this non-official code by removing it (in case of themes / modules: deactivate them, don't just remove them from the modules/, themes/ folder).
|是否自定义/编辑任何模板（.tpl）文件了？或者你是否在使用某第三方外观主题或模块？请尽量避免这种非官方代码所造成的破坏，你可以移除它们（拿外观主题/模块做个例子，只讲它们从modules/和themes/ 文件夹中移除是不够的）。
|-
|-
|ERROR_LOCK_TIMEOUT
|ERROR_LOCK_TIMEOUT
|See [[Gallery:FAQ#I_suddenly_got_an_.22ERROR_LOCK_TIMEOUT.22_message.2C_what_do_I_do.3F|FAQ: I suddenly get an ERROR_LOCK_TIMEOUT message, what can I do?]]
|参见[[Gallery:FAQ#我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？|常见问题：我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？]]
|-
|-
|ERROR_MISSING_ITEM
|ERROR_MISSING_ITEM
|
|
* If you can still access your 'Site Admin' section, you should consider running the 'integrity check' of the 3rd party module 'integrity'. It's available via 'Site admin' -> 'Plugins' since Gallery 2.2. See [[Gallery:Installing_Additional_Components|Installing Additional Components]].
* 如果你尚可访问'站点管理（Site Admin）'部分的话，你应当考虑运行第三方模块，'完整性（integrity）'模块的'完整性检查'。对于G2.2之后的版本来说，它可以在'站点管理（Site admin）' -> '插件（Plugins）'中找到。参见：[[Gallery:Installing_Additional_Components|额外组件的安装]]。
* TODO: Add link to instructions on how to manually fix such issues.
* 需要做的：为手动修复此类问题的相关指导添加链接。
|}
|}


=== Symptom / Attempted Action ===
=== 错误症状（Symptom）/尝试性动作（Attempted Action） ===
Please try to locate your issue in the below categorization. And don't forget that the [[Gallery:FAQ#How_to_set.2Fuse_Gallery_in_debug_mode.3F|debug mode]] can show a lot more information about a problem than you'd see without.
请在下面的分类中定位你碰到的问题。请记住，[[Gallery:FAQ#如何设置/使用Gallery的debug模式？|debug模式]]启用后可以显示更多该问题的相关信息，这与不使用debug模式具有天壤之别。


==== Installation ====
==== 安装 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't authenticate (Step 2) / login.txt
|无法通过验证（第二步）/login.txt
|See [[Gallery:FAQ#The_installer_does_not_accept_my_login.txt.2C_what.27s_wrong.3F|FAQ: The installer does not accept my login.txt file. What's wrong?]]
|参见[[Gallery:FAQ#为什么安装程序不接受我的login.txt？|常见问题：为什么安装程序不接受我的login.txt？]]
|-
|-
|System Checks report a problem with the 'file integrity'
|系统检查（System Checks）报告了有关'文件完整性'的问题
|See [[Gallery:FAQ#What_about_the_warning_for_missing_.26_modified_files_in_the_installer_.26_upgrader.3F|FAQ: What about the warning for missing / modified files in the installer?]]
|参见[[Gallery:FAQ#在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？|常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？]]
|-
|-
|Storage Setup (Step 4) - Error creating the directory structure
|存储的安装（Storage Setup）（第四步）-创建目录结构错误
|
|
* Mostly this can happen with Windows / IIS servers. See [[Gallery:Installation_on_Windows_Server_2003_and_IIS6|Installation in Windows Server]]
* 此错误多发生于Windows/IIS服务器。参见[[Gallery:Installation_on_Windows_Server_2003_and_IIS6|Windows Server中的安装]]
* In case it happens on a linux / unix server and you confirmed via FTP program that the permissions of the g2data folder are world-writeable (777), please talk to your webhost to find out why a PHP script wouldn't be allowed to create a folder structure in g2data/.
* 如果发生在linux / unix服务器上并且通过FTP客户端确定g2data文件夹的权限为world-writeable（777）的话，请要求你的webhost来查明为何在g2data/中不允许PHP脚本进行文件夹结构的创建。
|-
|-
|Storage Setup (Step 4) - Page blank / timing out when trying to submit
|存储的安装（Storage Setup）（第四步）-页面空白/尝试提交时超时
|In case you're using G2.1.2, try G2.2. And you should check the [[Gallery:FAQ#What_is_the_webserver_error_log.3F|error log of the webserver]].
|如果你在使用G2.1.2的话，请尝试使用G2.2版本。你也该看看[[Gallery:FAQ#web服务器错误日志（error log）是什么？|有关web服务器错误日志的相关信息]]。
|-
|-
|Losing Session / Falling back to authentication step
|失去对话（Losing Session）/回退到验证步骤
|In case you're using G2.1.2, try G2.2. (related cookieless issue in 2.1). Also you should check the session settings of PHP. You can look at the PHP settings with a PHPInfo page, which is explained in: [[Gallery:FAQ#What_information_is_required_when_I_ask_for_help_in_the_forums.3F|FAQ: What information is required when I ask for help in the forums?]]
|如果你在使用G2.1.2的话，请尝试使用G2.2版本（由于2.1版本中相关的cookieless问题）。你也应检查一下PHP的对话设定。你可以通过PHPInfo页面来查看PHP设定，这在此常见问题条目中有解释：[[Gallery:FAQ#在论坛寻求帮助时哪些信息是必要的？|常见问题：在论坛寻求帮助时哪些信息是必要的？]]
|-
|-
|Database Setup (Step 5) - Missing / Incorrect database connection information
|数据库安装（Database Setup）（第五步）-丢失的/错误的数据库连接信息
|
|
* The information to connect to your database is different for every host. Please ask your webhost for the correct database connection information.
* 数据库连接信息对每个host来说都是不同的。请询问你的webhost以获取正确的数据库连接信息。
* Usually, this information can also be found somewhere in your administration panel of your website (not part of Gallery).
* 此信息一般在网站的管理面板中可以找到（非Gallery的一部分）。
* Many webhosts add a prefix (e.g. your account name) to the database name and the database user name.
* 许多webhosts在数据库名称和数据库用户名称前添加了一个前缀（如你的帐户名称）。
* Don't bother changing the 'column prefix' and the 'table prefix' if you don't understand what they're for.
* 如果不了解'column prefix'和'table prefix'的话，请不要妄加修改。
|-
|-
|Database Setup (Step 5) - Client does not support authentication protocol
|数据库安装（Database Setup）（第五步）-客户端不支持验证协议
| See [[Gallery:FAQ#Why_can.27t_I_install_with_MySQL_4.1_or_higher.3F|FAQ: Why can't I install with MySQL 4.1 or higher?]] and [[Gallery:FAQ#MySQL_.22Client_does_not_support_authentication_protocol.22_error|FAQ: MySQL Client does not support authentication protocol error]]
| 参见[[Gallery:FAQ#为何使用MySQL 4.1或更高版本却不能进行安装？|常见问题：为何使用MySQL 4.1或更高版本却不能进行安装？]]以及[[Gallery:FAQ#MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"|常见问题：MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"]]
|-
|-
|Database Setup (Step 5) - Other connection problems
|数据库安装（Database Setup）（第五步）-其他的连接问题
|
|
* These are usually DB specific issues not related to Gallery specifically. You need to ensure that PHP can communicate with the database. Searching for the error message with Google is usually a good starting point.
* 这些通常是与Gallery无明显关系的数据库问题。你需要保证PHP能够与数据库进行沟通。使用Google来查找有关错误消息的信息是个不错的开端。
* One specific is: [[Gallery:FAQ#Why_do_I_get_a_MySQL_.22Can.27t_connect_to_local_MySQL_server_through_socket.22_error.3F|FAQ: Why do i get a MySQL 'Can't connect to local MySQL server through socket' error?]]
* 某特殊情况是：[[Gallery:FAQ#为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？|常见问题：为何得到这样一个MySQL的错误："无法通过socket接口连接MySQL本地服务器"？]]
|-
|-
|Database Setup (Step 5) - Non-Default Port
|数据库安装（Database Setup）（第五步）-非默认端口（Non-Default Port）
|If you need to use a non-default port, just append :xxxx to the Host Name, e.g. 'localhost:3307' for port 3307 on localhost.
|如果你需要使用一个非默认端口的话，请将:xxxx后置到主机名（Host Name）之后，如本地主机3307端口就是'localhost:3307'。
|-
|-
|Install Core Module (step 8) fails
|安装核心模块（Install Core Module）（第八步）失败
|
|
* See [[Gallery:FAQ#I_get_an_error_in_the_installation_step_8_.28installing_core_module.29._What.27s_wrong.3F|FAQ: I get an error in the installation step 8. What's wrong?]] (since Gallery 2.2, we warn you about this issue in the System Checks step already)
* 参见[[Gallery:FAQ#我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？|常见问题：我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？]]（对于Gallery 2.2以来的版本，我们在系统检查步骤中以对此问题作出了警告）
* Ensure that the PHP memory_limit is 16 MB or more. 8 MB is often not enough.
* 保证PHP memory_limit为16 MB或更高。8 MB往往不是很够。
* Refreshing the page / doing the step again does not help.
* 刷新页面或重新进行该步骤是没用的。
* Sometimes, the problem goes away by running the installer again.
* 有时重新运行安装程序可以解决问题。
* To retry, you need to delete the storage folder, drop the database and start the installer from step 4 (or earlier) again, redoing these steps. Note: To save you some time, you can just click on the "Database Setup" step link on the left, click "save" and then click "erase". That way you don't have to manually delete the storage folder and the database.
* 要重试的话，你需要删除存储文件夹，清除数据库并从第四步（或前面的步骤）中重启安装程序，再重复这些步骤。注：为了能够节省些时间，你可以点击左侧的"数据库安装（Database Setup）"步骤的链接，点击"保存（save）"，再点击"清除（erase）"。这样你就不用手动删除存储文件夹和数据库了。
|}
|}


==== Upgrade ====
==== 升级 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't authenticate (Step 2) / login.txt
|无法通过验证（第二步）/login.txt
|See [[Gallery:FAQ#The_installer_does_not_accept_my_login.txt.2C_what.27s_wrong.3F|FAQ: The installer does not accept my login.txt file. What's wrong?]] (applies to the upgrade wizard as well)
|参见[[Gallery:FAQ#为什么安装程序不接受我的login.txt？|常见问题：为什么安装程序不接受我的login.txt？]]（同样适用于升级向导）
|-
|-
|System Checks report a problem with the 'file integrity'
|系统检查（System Checks）报告了有关'文件完整性'的问题
|See [[Gallery:FAQ#What_about_the_warning_for_missing_.26_modified_files_in_the_installer_.26_upgrader.3F|FAQ: WHat about the warning for missing / modified / obsolete files in the upgrader?]]
|参见[[Gallery:FAQ#在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？|常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？]]
|-
|-
|System Checks report a problem with 'Storage Directory Permissions'
|系统检查（System Checks）报告有关'存储目录权限（Storage Directory Permissions）'的问题
|See [[Gallery:FAQ#How_can_I_fix_the_problem_with_the_Storage_Directory_Permissions_reported_by_the_Upgrade_Wizard.3F|FAQ: How can I fix the problem with the storage directory permissions reported by the upgrade wizard?]]
|参见[[Gallery:FAQ#如何修复升级向导所报告的Gallery存储文件夹文件系统权限问题？|常见问题：如何修复升级向导所报告的Gallery存储文件夹文件系统权限问题？]]
|-
|-
|Upgrade Core Module Step fails with error
|核心模块升级步骤由于出错而失败
|Do you see 'Illegal mix of collations' in the debug output? See [[Gallery:Known_Issues:MySQL_UTF8_Upgrade|MySQL UTF8 Upgrade]]
|是否在debug输出中看到'Illegal mix of collations'？参见[[Gallery:Known_Issues:MySQL_UTF8_Upgrade|MySQL UTF8 Upgrade]]
|-
|-
|Upgrade Other Modules Step reports missing plugins
|其他模块升级步骤报告有插件丢失
|
|
* You risk that your Gallery does not work correctly anymore if you upgrade without those modules. You should try to [[Downloads|get the latest version of these plugins]] and to put them into your Gallery modules/, themes/ folders before continuing to the next step of the upgrade wizard.
* 如果升级时没有包含这些模块的话，你的Gallery就有可能无法正常运行的风险。你应当尝试[[Downloads|获取最新版本的这些插件]]，并在继续升级程序中的下一步之前将它们置入你的Gallery modules/和themes/ 文件夹中。
* Also see [[Gallery:FAQ#I_get_a_warning_for_missing_themes_.2F_modules_in_the_upgrader.2C_what_should_I_do.3F|FAQ: I get a warning for missing themes / modules in the upgrader. What should I do?]]
* 另见[[Gallery:FAQ#在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？|常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？]]
|-
|-
|Some things don't work anymore after upgrading
|在升级结束后，某些东西将不复运行
|Maybe a plugin is missing or not active. Consolut ''Site Admin'' -> ''Plugins'' (G2.2, previous versions had ''Modules'') and ensure everything is the way you want it to be.
|可能某插件丢失或不处于激活状态。查看一下''站点管理（Site Admin）'' -> ''插件（Plugins）''（G2.2版本，之前版本是''模块（Modules）'')并确保它们各司其职。
|}
|}


==== Images ====
==== 图片 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Thumbnails / Resized Images don't get generated correctly
|无法正常生成缩略图或重设尺寸的图片
|See [[Gallery:FAQ#Thumbnails_.2F_resized_images_don.27t_get_generated_properly.2C_how_can_it_be_fixed.3F|FAQ: Thumbnails / resized images don't get generated properly. How can it be fixed?]]
|参见[[Gallery:FAQ#缩略图/重设尺寸的图片无法正常生成，如何修复？|常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？]]
|-
|-
|No images are shown at all
|不显示任何图片
|
|
* Not even original (fullsize) images?
* 连原始（全尺寸）图片都不显示了吗？
** See [[Gallery:FAQ#Images_don.27t_show_up_and_the_album_.2F_photo_links_don.27t_work.2C_what_can_I_do.3F|FAQ: Images don't show up and the album photo links don't work either. What can I do?]]
** 参见[[Gallery:FAQ#图片无法显示，相册/相片的链接无效，我该怎么办？|常见问题：图片无法显示，相册/相片的链接无效，我该怎么办？]]
** Maybe your webhost is corrupting the image transfers. Does your webhost automatically add ads / commercials to all pages of your website? If so, this is the likely reason. Ask your webhost if you can manually add the ads somewhere on the page and then disable the automatically added ads because they break Gallery 2.
** 也许你的webhost令图片传输崩溃了。你的webhost是否在你的网站所有页面中自动添加广告或商业信息？如果是的话，这很可能就是导致出问题的原因。询问你的webhost看看能否让你自己手动添加广告并禁用自动广告添加，因为这会令你的Gallery2崩溃。
* If original images show up correctly but thumbnails and resizes do not, please see [[Gallery:FAQ#Thumbnails_.2F_resized_images_don.27t_get_generated_properly.2C_how_can_it_be_fixed.3F|FAQ: Thumbnails / resized images don't get generated properly. How can it be fixed?]]
* 如果原始图片能正常显示，但是缩略图和重设尺寸的图片不可以的话，请参看[[Gallery:FAQ#缩略图/重设尺寸的图片无法正常生成，如何修复？|常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？]]
|-
|-
|Errors when trying to build thumbnails / resized images
|当尝试进行缩略图或重设尺寸图片创建时发生错误
|Uninstall and then reinstall image toolkits. Details: [[Gallery:FAQ#Thumbnails_.2F_resized_images_don.27t_get_generated_properly.2C_how_can_it_be_fixed.3F|FAQ: Thumbnails / resized images don't get generated properly. How can it be fixed?]]
|先将图片工具包卸载再重新进行安装。详细信息见于：[[Gallery:FAQ#缩略图/重设尺寸的图片无法正常生成，如何修复？|常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？]]
|-
|-
|Thumbnails are (not) square instead of preserving the normal aspect ratio
|缩略图（不）呈方（矩）形而不按正常的长宽比显示
|Gallery generates square thumbnails if the 'square thumbs' module is active. Deactivate this module in 'Site Admin' -> 'Plugins' ('Modules' until G2.2) to change this. To change existing thumbnails, you need to rebuild them. Go to 'Edit Album' -> 'Album' to rebuid existing thumbnails according to the new settings.
|当'square thumbs'模块处于激活状态时，Gallery就会生成方（矩）形缩略图。Deactivate this module in 在'站点管理（Site Admin）' -> '插件（Plugins）'中禁用此模块（G2.2版本以前为'模块（Modules）'）可改变这种状况。若要修改已有的缩略图，你需要对它们进行重建。打开'编辑相册（Edit Album）' -> '相册（Album）'并按照新的设定重建缩略图。
|-
|-
|Error when trying to view images
|尝试查看图片时发生错误
|What kind of error? See the below section about 'troubleshooting by error name'.
|是何种错误？参见以下有关'按错误名称解决问题'部分。
|-
|-
|Images load very slowly
|图片的读取速度太慢
|
|
* Apache mod_deflate / gzip not deactivated for binary files?
* Apache的mod_deflate/gzip没有对二进制文件禁用？
* Is the Server CPU, file I/O or bandwidth limited? See: [[Gallery:Performance_Tips|Performance Tips]]
* 服务器CPU，文件I/O或是带宽限制？参见[[Gallery:Performance_Tips|性能调校技巧]]
|-
|-
|Larger images are distored / corrupted
|较大尺寸的图片变形/崩溃
|
|
* Very rare issue. No details yet. We suspect webserver configuration issues / webserver bugs.
* 此问题较罕见。尚无相关的详细信息。我们怀疑是web服务器配置问题或web服务器的bug所致。
* Check via FTP whether the files in g2data/albums/ are correct. Helps to find out whether the files on the server are corrupted or if they get corrupted during the transfer to the browser.
* 使用FTP检查g2data/albums/下的文件是否正确。这能帮助你探明是服务器上的文件崩溃还是在向浏览器的传输过程中崩溃的。
|}
|}


==== Videos / Flash ====
==== 视频/Flash ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Download link instead of movie player
|显示的是下载链接而不是期望的电影播放器
|
|
* Did you set the dimensions of the video in 'Edit movie' -> 'Movie'? Gallery only shows an embedded movie player if the dimensions are set (to a value greater than 0). You can play the movie on your computer to find out its dimensions (movie players like VLC or Windows Media Player show the dimesions in the movie properties.
* 是否在'编辑电影（Edit movie）' -> '电影（Movie）'中对视频尺寸进行了设定？Gallery仅显示设定过尺寸（值大于0）的嵌入电影播放器。你可以先在计算机上播放此电影来查看其尺寸（类似VLC或Windows媒体播放器的电影播放器来说，尺寸的相关信息可在电影属性中找到）。
* Note: If the [[Gallery:Modules:ffmpeg|ffmpeg module]] is active, Gallery will detect and set the dimensions for all movies automatically (unless your ffmpeg binary can't handle a specific movie type).
* 注：如果[[Gallery:Modules:ffmpeg|ffmpeg模块]]处于激活状态的话，Gallery将会自动检查并为所有的电影设置尺寸（除非你的ffmpeg二进制无法处理某特定的电影格式）。
|-
|-
|No thumbnail for videos
|视频无缩略图
|
|
* Is the [[Gallery:Modules:ffmpeg|ffmpeg module]] active? Gallery can only generate thumbnails for movies with this module.
* [[Gallery:Modules:ffmpeg|ffmpeg模块]]是否启用了？仅当此模块启用时，Gallery才能够为电影生成缩略图。
* Can your ffmpeg binary handle the specific movie type? In 'Site Admin' -> 'ffmpeg' you can click 'Test' to see what types of video it should handle correctly.
* 你的ffmpeg二进制能否处理特定格式的电影？在'站点管理（Site Admin）' -> 'ffmpeg'中科点击'测试（Test）'来看看何种类型的视频可以被正确地处理。
|-
|-
|Cannot locate ffmpeg binary
|无法定位ffmpeg二进制
|Please see [[Gallery:Modules:ffmpeg|ffmpeg module]] for further information.
|请参考[[Gallery:Modules:ffmpeg|ffmpeg模块]]获取更详细的信息。
|-
|-
|Movies are not playing
|电影无法播放
|See [[Gallery:FAQ#Movies_are_not_playing_in_my_Gallery.2C_why.3F|FAQ: Movies are not playing, why?]]
|参见[[Gallery:FAQ#为什么电影无法在我的Gallery中播放了？|常见问题：为什么电影无法在我的Gallery中播放了？]]
|}
|}


==== Adding Items / Albums / Upload ====
==== 添加项目/相册/上传 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|I can't upload anything
|无法进行上传
|
|
* To diagnose this problem you should use the 'Add items' -> 'From browser' method since it shows most debug information.
* 要诊断此问题你应当使用'添加项目（Add items）' -> '自浏览器（From browser）'的方法，因为此方法能够提供最详实的debug信息。
* In case PHP uploads are disabled completely on your webserver, there is a warning about that on the 'Add items' -> 'From browser' page. Also, this page shows the upload limits.
* 若PHP上传在你的服务器上完全被禁用的话，在'添加项目（Add items）' -> '自浏览器（From browser）'页面上会有警告提示。此页面同样显示有上传限制。
* What exactly do you see when you try to upload a file? Any errors?
* 当你尝试上传一个文件时看到了什么？错误吗？
* Verify that PHP's ''upload_tmp_dir'' is configured correctly. If you consult your webserver's error log, you might see 'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'. In that case, upload_tmp_dir is either not defined or the webserver doesn't have access to write a file in that directory. Other errors / warnings might have the same cause.
* 确保PHP的''upload_tmp_dir''配置无误。如果查看你的web服务器日志的话，可能会看到'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'这样的错误。这种情况下，upload_tmp_dir不是没有被定义就是web服务器不具备该目录的文件写入权限。其他错误或警告可能是同样情况。
|-
|-
|I can't upload big files
|无法上传大文件
|See [[Gallery:FAQ#Why_can.27t_I_upload_big_files_.28over_a_megabyte_or_two.29.3F|FAQ: Why can't I upload big files (e.g. over a megabyte or two)?]]
|参见[[Gallery:FAQ#为何我不能上传大文件（1MB或2MB的文件）？|常见问题：为何我不能上传大文件（1MB或2MB的文件）？]]
|-
|-
|I get an ERROR_STORAGE_FAILURE after I click the upload button
|点击上传按钮后出现这样的错误ERROR_STORAGE_FAILURE
|See [[Gallery:FAQ#I_get_ERROR_STORAGE_FAILURE_when_adding_new_photos_or_creating_albums.2C_what_should_I_do.3F|FAQ: I get ERROR_STORAGE_FAILURE when adding new photos or creating albums, what should I do?]]
|参见[[Gallery:FAQ#添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？|常见问题：添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？]]
|}
|}


==== Login====
==== 登录====
See [[Gallery:FAQ#I_can.27t_login_anymore.2C_what_can_I_do_now.3F|FAQ: I can't login anymore, what can I do?]]
参见[[Gallery:FAQ#我怎么都无法登录了，怎么办？|常见问题：我怎么都无法登录了，怎么办？]]


{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Login fails with error / warning
|登录失败，发生错误或警告
|
|
* Forgot password? (does email not work? Contact admin, admins can use login.txt instead and fix email or reset the user account)
* 忘记密码了？（Email找回密码的方式无效了？请联系管理员，管理员可以使用login.txt来修复Email或重置用户帐户）
* Do you have any special characters in your password? Prior to Gallery 2.1 this could lead to login problems under certain circumstances. Consider upgrading your Gallery.
* 密码中是否含有特殊字符？在Gallery2.1版之前，在某些情况下这将会导致登录时出现问题。请考虑升级你的Gallery。
* Does it say your user account is "disabled"? (since G2.2) Use the "Forgot Password" link on the login page to reactivate your account.
* 是否显示你的用户帐户被"禁用"了？（G2.2版本以来）请使用登录页面上的"忘记密码（Forgot Password）"链接来重新激活你的帐户。
|-
|-
|Login fails and just displays a normal Gallery page again
|登录失败，然后再次显示的还是一个正常的Gallery页面
|
|
* Often clearing the browser cookie cache helps. Check your web-browser settings and clear the cookies for your Gallery website.
* 往往清除浏览器cookie缓存会有一定效果。检查你的web浏览器设定，清除Gallery站点的cookies。
* Sometimes, you are actually logged in but still see a page that looks like you are not logged in because your browser did not update its own cache. Please check your web-browser settings and clear the browser cache.
* 有时你会在登录后看到的还是登录页面，因此就认为没有登录成功，但是实际上你已经登录了；但是由于你的浏览器没有更新其缓存，所以会出现这种情况。请检查你web浏览器的设定并清除浏览器缓存。
* Is your webserver IIS/5.0 or older and is your Gallery 2 version older than 2.0? We added a workaround for an IIS bug shortly before the official release of Gallery 2.0, you should upgrade your Gallery.
* 你的web服务器IIS/5.0版本过旧还是你的Gallery2的版本低于2.0？在Gallery2.0发布前不久我们就为某IIS bug添加了一个变通的修复手段，你应当升级你的Gallery。
|}
|}




==== Toolkits / Module Activation ====
==== 工具包/模块的激活 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|There are errors when trying to test the binaries (or when saving the configuration)
|在尝试测试二进制（或保存配置）时发生了错误
|
|
* See: [[Installing_an_Image_Processing_Library|Installing an Image processing Library]]
* 参见：[[Gallery:Installing_an_Image_Processing_Library|图片处理库的安装]]
* Does it report that it can't find files at the given path? See the note about the 'path' in the above linked article.
* 错误报告是否为指定路径下找不到文件？参见以上链接文章中有关'路径'的注释。
|-
|-
|netpbm reports 'errno 13 (permission denied)' or ' Error reading magic number' when testing binaries
|在测试二进制时，netpbm报告'errno 13 (permission denied)'的错误或' Error reading magic number'的错误
|If you are sure that filesystem permissions are correct, please check [[Gallery:Installation_on_a_SELinux_Server|Installation on a SELinux Server]] as well.
|如果你确定文件系统权限设置无误的话，请查看一下[[Gallery:Installation_on_a_SELinux_Server|在SELinux服务器上安装]]的相关信息。
|-
|-
|Windows / IIS specific: I cannot install any binaries
|Windows/IIS：我无法安装任何二进制
|See [[Gallery:Installation_on_Windows_Server_2003_and_IIS6#Installing_Binaries|Installing binaries on a MS Windows / IIS server]]
|参见[[Gallery:Installation_on_Windows_Server_2003_and_IIS6#二进制的安装|在MS Windows/IIS服务器上进行二进制的安装]]。
|-
|-
|Windows specific: Warnings about 'unable to fork'
|Windows: 有关'unable to fork'的警告
|See [[Gallery:FAQ#I_get_lots_of_.22Warning:_exec.28.29:_Unable_to_fork_.5Bcmd_.2Fc_....5D.22_at_the_module.27s_step_in_the_installer_for_G2_.28on_the_ImageMagick_module.29_under_Windows.2FIIS._Now_what.3F|FAQ: I get lot's of 'unable to fork' warnings, what should I do?]]
|参见[[Gallery:FAQ#我在Windows/IIS下G2安装程序的模块步骤得到了许多"Warning: exec(): Unable to fork [cmd /c ...]"（ImageMagick模块）这样的警告提示，该怎么办？|常见问题：我在Windows/IIS下G2安装程序的模块步骤得到了许多"Warning: exec(): Unable to fork [cmd /c ...]"（ImageMagick模块）这样的警告提示，该怎么办？]]
|}
|}


==== Themes ====
==== 外观主题 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't upload theme into themes/ folder
|无法将外观主题上传至themes/文件夹
|See [[Gallery:FAQ#How_can_I_upload_a_theme_or_module_via_FTP_when_I_used_the_preinstaller.3F|FAQ: How can I upload a theme or module via FTP when I used the preinstaller?]]
|参见[[Gallery:FAQ#当使用预安装程序后，如何通过FTP软件上传一个外观主题或模块？|常见问题：当使用预安装程序后，如何通过FTP软件上传一个外观主题或模块？]]
|-
|-
|Can't edit theme settings
|无法编辑外观主题的设定
|
|
* Does it work for the 'matrix' theme but not for a 3rd party theme? Then it's probably a specific problem with the 3rd party theme and you should contact its author.
* 是否仅可编辑'matrix'外观主题而不能编辑某第三方外观主题？如果是这样的话，那么这就很可能是第三方外观主题特有问题了，因此你最好直接联系此第三方外观主题的编写者。
* Is JavaScript enabled in your browser?
* 你的浏览器是否允许Java脚本语言？
* Does it show no theme blocks at all? Maybe your webserver is not configured properly and blocks JavaScript requests. Or it doesn't return the right content-type for JavaScript files. Please browse to {{exampleurl|/lib/javascript/BlockSelectWidget.js}} (change the URL to match your Gallery location) and if the JavaScript code of the file displays correctly in your browser (or if you can safe the file on your computer), then it's working fine. If not, it is probably a 'mod_security' problem. See: [[Gallery:Known_Issues|Known Issues -> Apache mod_security]]. Your webhost should be notified about the problem such that they can fix the webserver configuration.
* 外观主题区块是否毫无显示？有可能你的web浏览器没有正确配置因此拦截了JavaScript的请求。或者为JavaScript所返回的内容类型不正确。请浏览{{exampleurl|/lib/javascript/BlockSelectWidget.js}}（修改其中的URL地址为你Gallery的位置），如果文件的JavaScript代码在你的web浏览器中显示正确（或可以保证你计算机上文件安全）的话，那么就没问题了。相反，则有可能是'mod_security'的问题了。参见：[[Gallery:Known_Issues|已知问题 -> Apache mod_security]]。你的webhost应当被告知此问题，这样他们才能对web服务器的配置进行修复。
|-
|-
|Nothing works anymore after changing theme
|在修改外观主题后，所有东西都无法运行了
|See [[Gallery:FAQ#I_have_changed_the_default_theme_and_nothing_works_anymore._How_can_I_switch_back.3F|FAQ: I have changed the default theme and nothing works anymore. How can I switch back?]]
|参见[[Gallery:FAQ#我修改了默认外观主题但什么都运行不了了。怎样才能还原？|常见问题：我修改了默认外观主题但什么都运行不了了。怎样才能还原？]]
|-
|-
|Can't reach 'Site admin'
|无法访问'站点管理（Site admin）'
|See [[Gallery:FAQ#How_can_I_change_the_default_theme_when_I_can.27t_reach_site_admin.3F|FAQ: How can I change the default theme when I can't reach 'Site admin'?]]
|参见[[Gallery:FAQ#在无法访问站点管理的情况下如何改变默认的外观主题？|常见问题：在无法访问站点管理的情况下如何改变默认的外观主题？]]
|}
|}


==== Modules ====
==== 模块 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Can't upload module into modules/ folder
|无法将模块上传至modules/文件夹
|See [[Gallery:FAQ#How_can_I_upload_a_theme_or_module_via_FTP_when_I_used_the_preinstaller.3F|FAQ: How can I upload a theme or module via FTP when I used the preinstaller?]]
|参见[[Gallery:FAQ#当使用预安装程序后，如何通过FTP软件上传一个外观主题或模块？|常见问题：当使用预安装程序后，如何通过FTP软件上传一个外观主题或模块？]]
|}
|}


==== Translation / Localization ====
==== 翻译/本地化 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Changing language does not work
|无法修改语言
|See [[Gallery:FAQ#I_changed_the_language_but_nothing_happens.2C_what.27s_wrong.3F|FAQ: I changed the language but nothing happens, what's wrong?]]
|参见[[Gallery:FAQ#我修改了语言但是没有效果，这是怎么回事？|常见问题：我修改了语言但是没有效果，这是怎么回事？]]
|-
|-
|"Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request"
|"Wrong charset, cannot convert"或"Illegal character encoding"或"Illegal recode request"的错误
|See [[Gallery:FAQ#Where_I_should_see_dates_I_see_.22Wrong_charset.2C_cannot_convert.22_or_.22Illegal_character_encoding.22_or_.22Illegal_recode_request.22.._what_is_wrong.3F|FAQ: Where I should see dates I see "Wrong charset, cannot convert" or "Illegal character encoding" or "Illegal recode request".. what is wrong?]]
|参见[[Gallery:FAQ#应该显示日期的地方我却看到"Wrong charset, cannot convert"或"Illegal character encoding"还有"Illegal recode request".. 这是怎么回事？|常见问题：应该显示日期的地方我却看到"Wrong charset, cannot convert"或"Illegal character encoding"还有"Illegal recode request".. 这是怎么回事？]]
|}
|}


==== Other ====
==== 其他 ====
{|class="gallery" style="background-color: #eee; width:90%"
{|class="gallery" style="background-color: #eee; width:90%"
!Symptom / Attempted Action!!Solution
!错误症状/尝试性动作!!解决办法
|-
|-
|Blank / Empty Page
|空白/为空页面
|See [[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|FAQ: I get only a blank screen when trying to view my Gallery. What's wrong?]]
|参见[[Gallery:FAQ#当我尝试查看gallery时却显示一个空白屏幕，怎么回事？|常见问题：当我尝试查看gallery时却显示一个空白屏幕，怎么回事？]]
|-
|-
|Error when editing an album / photo item
|编辑某相册或相片项目时发生错误
|ERROR_OBSOLETE_DATA? -> Clearing the cache might help: [[Gallery:FAQ#How_can_I_clear_cached_data.3F|FAQ: How can I clear cached data?]]
|ERROR_OBSOLETE_DATA的错误？-> 清除缓存可能会有效：[[Gallery:FAQ#如何清除缓存数据？|常见问题：如何清除缓存数据？]]
|-
|-
|PHP memory_limit - Allowed memory size exhausted
|PHP的memory_limit–被允许的内存耗尽
|[[Gallery:FAQ#PHP_memory_limit_-_Why_do_I_get_the_error_Allowed_memory_size_of_Xxx_bytes_exhausted.3F|FAQ: Why do I get the error 'Allowed memory size of Xxx bytes exhausted?]]
|[[Gallery:FAQ#为何出现这的错误：被允许的XxxB的内存被耗尽|常见问题：为何出现这的错误：被允许的XxxB的内存被耗尽]]
|-
|-
|Performance - Page loads are slow
|性能-页面载入速度很慢
|Is the Server CPU, file I/O or bandwidth limited? See: [[Gallery:Performance_Tips|Performance Tips]]
|服务器的CPU，文件I/O或带宽有限制？参见：[[Gallery:Performance_Tips|性能调校技巧]]
|-
|-
|Nothing happens when I click on a link / thumbnail
|点击某链接或缩略图后没有任何反应
|Probably due to a memory limit or a fatal webserver error. See: [[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|FAQ:  get only a blank screen when trying to view my Gallery, what's wrong?]]
|可能是由于内存限制或web服务器发生了致命错误所导致。参见：[[Gallery:FAQ#当我尝试查看gallery时却显示一个空白屏幕，怎么回事？|常见问题： 当我尝试查看gallery时却显示一个空白屏幕，怎么回事？]]
|-
|-
|'Site admin' link does not work
|'站点管理（Site admin）'链接无效
|
|
* Does the link point to '/admin/'? If so, then it's likely that your URL rewrite module doesn't work correctly. You should disable it. See: [[Gallery:FAQ#Images_don.27t_show_up_and_the_album_.2F_photo_links_don.27t_work.2C_what_can_I_do.3F|FAQ: Images don't show up and the album / photo links don't work, what can I do?]]
* 链接是否指向'/admin/'？如果是的话，那么问题就很可能出在你的URL重写模块上，它可能没有正常运行。因此你应当禁用此模块。参见：[[Gallery:FAQ#图片无法显示，相册/相片的链接无效，我该怎么办？|常见问题：图片无法显示，相册/相片的链接无效，我该怎么办？]]
* Also check: [[Gallery:FAQ#I_get_only_a_blank_screen_when_trying_to_view_my_Gallery.2C_what.27s_wrong.3F|FAQ: About blank screens]] (the notes about memory_limit and webserver error log are helpful here too)
* 另外也请参看一下：[[Gallery:FAQ#当我尝试查看gallery时却显示一个空白屏幕，怎么回事？|常见问题：当我尝试查看gallery时却显示一个空白屏幕，怎么回事？]]（有关memory_limit和web服务器错误日志的注解在此也有一定帮助的）
|-
|-
|'HTTP/1.1 503 Server too busy' with IIS / fastcgi (usually just for 'Site Admin')
|IIS / fastcgi的'HTTP/1.1 503 Server too busy'的错误（常常发生于'站点管理（Site Admin）'）
|
|
* This seems to be a bug in [http://www.caraveo.com/fastcgi/ isapi_fcgi.dll] (the initial fastcgi implementation). See the resolution of [http://bugs.php.net/bug.php?id=37448&thanks=6 PHP bug #37448].
* 这似乎是[http://www.caraveo.com/fastcgi/ isapi_fcgi.dll]的一个bug（首次fastcgi实现）。参见[http://bugs.php.net/bug.php?id=37448&thanks=6 PHP bug #37448]的修复办法。
* We suggest you rather try mod_php (instead of fastcgi) or you can use [http://www.iis.net/default.aspx?tabid=2&subtabid=25&i=1207 Microsoft's IIS FastCGI component] (a more recent FastCGI implementation) or use the [http://www.apache.org/ Apache Webserver] (usually easier to install, it's our recommended platform) instead.
* 我们建议你尝试使用mod_php（而不要使用fastcgi）或使用[http://www.iis.net/default.aspx?tabid=2&subtabid=25&i=1207 Microsoft's IIS FastCGI 组件]（最新的FastCGI实现）或使用[http://www.apache.org/ Apache Web服务器]（安装通常更为简便，这是我们推荐使用的平台）。
|-
|-
|No edit link / cannot edit album / item
|无编辑链接/无法编辑相册或项目
|
|
* In case you removed the 'Item Actions' block from your theme settings, Gallery should display a small "edit" link in most themes. You can add this link to your themes with <pre>{g->block type="core.EmergencyEditItemLink" class="gbBlock"}</pre>
* 如果你从外观主题设定中移除了'项目动作（Item Actions）'区块的话，Gallery在大部分外观主题中应该会显示一个小的"编辑"链接。你可以使用<pre>{g->block type="core.EmergencyEditItemLink" class="gbBlock"}</pre>将此链接添加到你的外观主题中去。
* Else, verify that you're logged in with the admin user or any other user with sufficient permissions and consider clearing your browser's cache.
* 如果不是上述情况的话，请确保你以管理员身份或有足够权限的其他用户身份登录的，然后可以考虑清除你浏览器的缓存。
|-
|-
|Some Error (don't know more)
|某错误（无更详细的相关信息）
|
|
* Enable buffered debug mode to see the exact error name. See the below section about 'troubleshooting by error name'.
* 启用buffered debug模式来看看准确的错误名称。参见以后部分中的'按错误名称解决问题'。
* Does the error occur when browsing to your Gallery on the front page or only when you browse to a specific page?
* 是否在浏览首页上Gallery时发生的错误，或者是浏览某特定页面时发生错误？
|}
|}


[[Category:Gallery 2:Troubleshooting|Troubleshooting]]
[[Category:Gallery 2:Troubleshooting|Troubleshooting]]

2008年8月9日 (六) 10:23的最新版本

Gallery2疑难解答[ ]

Gallery2疑难解答的更多链接：Category:Gallery 2:Troubleshooting

需要预先做好的工作[ ]

  1. 清除Gallery缓存！-参见如何清除缓存数据？
  2. 确保Gallery应用程序文件完好无损！-常见问题：如何确保安装文件完整无损？
  3. 清除web浏览器缓存（cookies及页面缓存）！
  4. 启用'buffered'debug模式以确保没有遗漏任何重要警告或详细信息

重要提示： 如果你没有以管理员身份登录的话，你需要启用'buffered'debug模式来检查错误名称及详细信息。参见：常见问题：如何设置/使用Gallery的debug模式？。如果'buffered' debug模式没有任何显示的话，你可以尝试'immediate'或'logged' debug模式。

解决手段...[ ]

你可以查找相应特定的'错误名称'来确定遇到的问题，或者在经过分类的症状中对号入座。

错误名称（Error Name）[ ]

是不是在访问Gallery首页时就发生了错误？如果错误仅当浏览特定页面/相册时发生或尝试进行某特殊动作时发生的话，你应当先通过错误症状/尝试进行的动作的分类来尝试解决问题（见下表）。

错误名称 解决办法
ERROR_PLATFORM_FAILURE 常见问题：如何修复Gallery存储文件夹文件系统权限问题？
ERROR_OBSOLETE_DATA 常见问题：如何清除缓存数据？
ERROR_REQUEST_FORGED
  • 登出或清除浏览器cookies并重试。
  • 如果你的Gallery被整合在了一个blog，门户或论坛等之中的话，请确保是使用的整合是最新版本的。
ERROR_STORAGE_FAILURE
ERROR_BAD_PARAMETER 是否自定义/编辑任何模板（.tpl）文件了？或者你是否在使用某第三方外观主题或模块？请尽量避免这种非官方代码所造成的破坏，你可以移除它们（拿外观主题/模块做个例子，只讲它们从modules/和themes/ 文件夹中移除是不够的）。
ERROR_LOCK_TIMEOUT 参见常见问题：我突然得到了此错误消息"ERROR_LOCK_TIMEOUT"，我该怎么办？
ERROR_MISSING_ITEM
  • 如果你尚可访问'站点管理（Site Admin）'部分的话，你应当考虑运行第三方模块，'完整性（integrity）'模块的'完整性检查'。对于G2.2之后的版本来说，它可以在'站点管理（Site admin）' -> '插件（Plugins）'中找到。参见：额外组件的安装。
  • 需要做的：为手动修复此类问题的相关指导添加链接。

错误症状（Symptom）/尝试性动作（Attempted Action）[ ]

请在下面的分类中定位你碰到的问题。请记住，debug模式启用后可以显示更多该问题的相关信息，这与不使用debug模式具有天壤之别。

安装[ ]

错误症状/尝试性动作 解决办法
无法通过验证（第二步）/login.txt 参见常见问题：为什么安装程序不接受我的login.txt？
系统检查（System Checks）报告了有关'文件完整性'的问题 参见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
存储的安装（Storage Setup）（第四步）-创建目录结构错误
  • 此错误多发生于Windows/IIS服务器。参见Windows Server中的安装
  • 如果发生在linux / unix服务器上并且通过FTP客户端确定g2data文件夹的权限为world-writeable（777）的话，请要求你的webhost来查明为何在g2data/中不允许PHP脚本进行文件夹结构的创建。
存储的安装（Storage Setup）（第四步）-页面空白/尝试提交时超时 如果你在使用G2.1.2的话，请尝试使用G2.2版本。你也该看看有关web服务器错误日志的相关信息。
失去对话（Losing Session）/回退到验证步骤 如果你在使用G2.1.2的话，请尝试使用G2.2版本（由于2.1版本中相关的cookieless问题）。你也应检查一下PHP的对话设定。你可以通过PHPInfo页面来查看PHP设定，这在此常见问题条目中有解释：常见问题：在论坛寻求帮助时哪些信息是必要的？
数据库安装（Database Setup）（第五步）-丢失的/错误的数据库连接信息
  • 数据库连接信息对每个host来说都是不同的。请询问你的webhost以获取正确的数据库连接信息。
  • 此信息一般在网站的管理面板中可以找到（非Gallery的一部分）。
  • 许多webhosts在数据库名称和数据库用户名称前添加了一个前缀（如你的帐户名称）。
  • 如果不了解'column prefix'和'table prefix'的话，请不要妄加修改。
数据库安装（Database Setup）（第五步）-客户端不支持验证协议 参见常见问题：为何使用MySQL 4.1或更高版本却不能进行安装？以及常见问题：MySQL错误："客户端不支持验证协议（Client does not support authentication protocol）"
数据库安装（Database Setup）（第五步）-其他的连接问题
数据库安装（Database Setup）（第五步）-非默认端口（Non-Default Port） 如果你需要使用一个非默认端口的话，请将:xxxx后置到主机名（Host Name）之后，如本地主机3307端口就是'localhost:3307'。
安装核心模块（Install Core Module）（第八步）失败
  • 参见常见问题：我在安装的第八个步骤（核心模块的安装）时，遇到了错误。怎么回事？（对于Gallery 2.2以来的版本，我们在系统检查步骤中以对此问题作出了警告）
  • 保证PHP memory_limit为16 MB或更高。8 MB往往不是很够。
  • 刷新页面或重新进行该步骤是没用的。
  • 有时重新运行安装程序可以解决问题。
  • 要重试的话，你需要删除存储文件夹，清除数据库并从第四步（或前面的步骤）中重启安装程序，再重复这些步骤。注：为了能够节省些时间，你可以点击左侧的"数据库安装（Database Setup）"步骤的链接，点击"保存（save）"，再点击"清除（erase）"。这样你就不用手动删除存储文件夹和数据库了。

升级[ ]

错误症状/尝试性动作 解决办法
无法通过验证（第二步）/login.txt 参见常见问题：为什么安装程序不接受我的login.txt？（同样适用于升级向导）
系统检查（System Checks）报告了有关'文件完整性'的问题 参见常见问题：在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事？
系统检查（System Checks）报告有关'存储目录权限（Storage Directory Permissions）'的问题 参见常见问题：如何修复升级向导所报告的Gallery存储文件夹文件系统权限问题？
核心模块升级步骤由于出错而失败 是否在debug输出中看到'Illegal mix of collations'？参见MySQL UTF8 Upgrade
其他模块升级步骤报告有插件丢失
在升级结束后，某些东西将不复运行 可能某插件丢失或不处于激活状态。查看一下站点管理（Site Admin） -> 插件（Plugins）（G2.2版本，之前版本是模块（Modules）)并确保它们各司其职。

图片[ ]

错误症状/尝试性动作 解决办法
无法正常生成缩略图或重设尺寸的图片 参见常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
不显示任何图片
当尝试进行缩略图或重设尺寸图片创建时发生错误 先将图片工具包卸载再重新进行安装。详细信息见于：常见问题：缩略图/重设尺寸的图片无法正常生成，如何修复？
缩略图（不）呈方（矩）形而不按正常的长宽比显示 当'square thumbs'模块处于激活状态时，Gallery就会生成方（矩）形缩略图。Deactivate this module in 在'站点管理（Site Admin）' -> '插件（Plugins）'中禁用此模块（G2.2版本以前为'模块（Modules）'）可改变这种状况。若要修改已有的缩略图，你需要对它们进行重建。打开'编辑相册（Edit Album）' -> '相册（Album）'并按照新的设定重建缩略图。
尝试查看图片时发生错误 是何种错误？参见以下有关'按错误名称解决问题'部分。
图片的读取速度太慢
  • Apache的mod_deflate/gzip没有对二进制文件禁用？
  • 服务器CPU，文件I/O或是带宽限制？参见性能调校技巧
较大尺寸的图片变形/崩溃
  • 此问题较罕见。尚无相关的详细信息。我们怀疑是web服务器配置问题或web服务器的bug所致。
  • 使用FTP检查g2data/albums/下的文件是否正确。这能帮助你探明是服务器上的文件崩溃还是在向浏览器的传输过程中崩溃的。

视频/Flash[ ]

错误症状/尝试性动作 解决办法
显示的是下载链接而不是期望的电影播放器
  • 是否在'编辑电影（Edit movie）' -> '电影（Movie）'中对视频尺寸进行了设定？Gallery仅显示设定过尺寸（值大于0）的嵌入电影播放器。你可以先在计算机上播放此电影来查看其尺寸（类似VLC或Windows媒体播放器的电影播放器来说，尺寸的相关信息可在电影属性中找到）。
  • 注：如果ffmpeg模块处于激活状态的话，Gallery将会自动检查并为所有的电影设置尺寸（除非你的ffmpeg二进制无法处理某特定的电影格式）。
视频无缩略图
  • ffmpeg模块是否启用了？仅当此模块启用时，Gallery才能够为电影生成缩略图。
  • 你的ffmpeg二进制能否处理特定格式的电影？在'站点管理（Site Admin）' -> 'ffmpeg'中科点击'测试（Test）'来看看何种类型的视频可以被正确地处理。
无法定位ffmpeg二进制 请参考ffmpeg模块获取更详细的信息。
电影无法播放 参见常见问题：为什么电影无法在我的Gallery中播放了？

添加项目/相册/上传[ ]

错误症状/尝试性动作 解决办法
无法进行上传
  • 要诊断此问题你应当使用'添加项目（Add items）' -> '自浏览器（From browser）'的方法，因为此方法能够提供最详实的debug信息。
  • 若PHP上传在你的服务器上完全被禁用的话，在'添加项目（Add items）' -> '自浏览器（From browser）'页面上会有警告提示。此页面同样显示有上传限制。
  • 当你尝试上传一个文件时看到了什么？错误吗？
  • 确保PHP的upload_tmp_dir配置无误。如果查看你的web服务器日志的话，可能会看到'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'这样的错误。这种情况下，upload_tmp_dir不是没有被定义就是web服务器不具备该目录的文件写入权限。其他错误或警告可能是同样情况。
无法上传大文件 参见常见问题：为何我不能上传大文件（1MB或2MB的文件）？
点击上传按钮后出现这样的错误ERROR_STORAGE_FAILURE 参见常见问题：添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误，我该怎么办？

登录[ ]

参见常见问题：我怎么都无法登录了，怎么办？

错误症状/尝试性动作 解决办法
登录失败，发生错误或警告
  • 忘记密码了？（Email找回密码的方式无效了？请联系管理员，管理员可以使用login.txt来修复Email或重置用户帐户）
  • 密码中是否含有特殊字符？在Gallery2.1版之前，在某些情况下这将会导致登录时出现问题。请考虑升级你的Gallery。
  • 是否显示你的用户帐户被"禁用"了？（G2.2版本以来）请使用登录页面上的"忘记密码（Forgot Password）"链接来重新激活你的帐户。
登录失败，然后再次显示的还是一个正常的Gallery页面
  • 往往清除浏览器cookie缓存会有一定效果。检查你的web浏览器设定，清除Gallery站点的cookies。
  • 有时你会在登录后看到的还是登录页面，因此就认为没有登录成功，但是实际上你已经登录了；但是由于你的浏览器没有更新其缓存，所以会出现这种情况。请检查你web浏览器的设定并清除浏览器缓存。
  • 你的web服务器IIS/5.0版本过旧还是你的Gallery2的版本低于2.0？在Gallery2.0发布前不久我们就为某IIS bug添加了一个变通的修复手段，你应当升级你的Gallery。


工具包/模块的激活[ ]

错误症状/尝试性动作 解决办法
在尝试测试二进制（或保存配置）时发生了错误
  • 参见：图片处理库的安装
  • 错误报告是否为指定路径下找不到文件？参见以上链接文章中有关'路径'的注释。
在测试二进制时，netpbm报告'errno 13 (permission denied)'的错误或' Error reading magic number'的错误 如果你确定文件系统权限设置无误的话，请查看一下在SELinux服务器上安装的相关信息。
Windows/IIS：我无法安装任何二进制 参见在MS Windows/IIS服务器上进行二进制的安装。
Windows: 有关'unable to fork'的警告 参见[[Gallery:FAQ#我在Windows/IIS下G2安装程序的模块步骤得到了许多"Warning: exec(): Unable to fork [cmd /c ...]"（ImageMagick模块）这样的警告提示，该怎么办？|常见问题：我在Windows/IIS下G2安装程序的模块步骤得到了许多"Warning: exec(): Unable to fork [cmd /c ...]"（ImageMagick模块）这样的警告提示，该怎么办？]]

外观主题[ ]

错误症状/尝试性动作 解决办法
无法将外观主题上传至themes/文件夹 参见常见问题：当使用预安装程序后，如何通过FTP软件上传一个外观主题或模块？
无法编辑外观主题的设定
  • 是否仅可编辑'matrix'外观主题而不能编辑某第三方外观主题？如果是这样的话，那么这就很可能是第三方外观主题特有问题了，因此你最好直接联系此第三方外观主题的编写者。
  • 你的浏览器是否允许Java脚本语言？
  • 外观主题区块是否毫无显示？有可能你的web浏览器没有正确配置因此拦截了JavaScript的请求。或者为JavaScript所返回的内容类型不正确。请浏览http://www.example.com/gallery/lib/javascript/BlockSelectWidget.js（修改其中的URL地址为你Gallery的位置），如果文件的JavaScript代码在你的web浏览器中显示正确（或可以保证你计算机上文件安全）的话，那么就没问题了。相反，则有可能是'mod_security'的问题了。参见：已知问题 -> Apache mod_security。你的webhost应当被告知此问题，这样他们才能对web服务器的配置进行修复。
在修改外观主题后，所有东西都无法运行了 参见常见问题：我修改了默认外观主题但什么都运行不了了。怎样才能还原？
无法访问'站点管理（Site admin）' 参见常见问题：在无法访问站点管理的情况下如何改变默认的外观主题？

模块[ ]

错误症状/尝试性动作 解决办法
无法将模块上传至modules/文件夹 参见常见问题：当使用预安装程序后，如何通过FTP软件上传一个外观主题或模块？

翻译/本地化[ ]

错误症状/尝试性动作 解决办法
无法修改语言 参见常见问题：我修改了语言但是没有效果，这是怎么回事？
"Wrong charset, cannot convert"或"Illegal character encoding"或"Illegal recode request"的错误 参见常见问题：应该显示日期的地方我却看到"Wrong charset, cannot convert"或"Illegal character encoding"还有"Illegal recode request".. 这是怎么回事？

其他[ ]

错误症状/尝试性动作 解决办法
空白/为空页面 参见常见问题：当我尝试查看gallery时却显示一个空白屏幕，怎么回事？
编辑某相册或相片项目时发生错误 ERROR_OBSOLETE_DATA的错误？-> 清除缓存可能会有效：常见问题：如何清除缓存数据？
PHP的memory_limit–被允许的内存耗尽 常见问题：为何出现这的错误：被允许的XxxB的内存被耗尽
性能-页面载入速度很慢 服务器的CPU，文件I/O或带宽有限制？参见：性能调校技巧
点击某链接或缩略图后没有任何反应 可能是由于内存限制或web服务器发生了致命错误所导致。参见：常见问题： 当我尝试查看gallery时却显示一个空白屏幕，怎么回事？
'站点管理（Site admin）'链接无效
IIS / fastcgi的'HTTP/1.1 503 Server too busy'的错误（常常发生于'站点管理（Site Admin）'）
无编辑链接/无法编辑相册或项目
  • 如果你从外观主题设定中移除了'项目动作（Item Actions）'区块的话，Gallery在大部分外观主题中应该会显示一个小的"编辑"链接。你可以使用
    {g->block type="core.EmergencyEditItemLink" class="gbBlock"}
    将此链接添加到你的外观主题中去。
  • 如果不是上述情况的话，请确保你以管理员身份或有足够权限的其他用户身份登录的，然后可以考虑清除你浏览器的缓存。
某错误（无更详细的相关信息）
  • 启用buffered debug模式来看看准确的错误名称。参见以后部分中的'按错误名称解决问题'。
  • 是否在浏览首页上Gallery时发生的错误，或者是浏览某特定页面时发生错误？
取自“https://www.zzbaike.com/wiki/index.php?title=Gallery:疑难解答&oldid=8460”